Sparkdo.ObjectExtending 1.0.2

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package Sparkdo.ObjectExtending --version 1.0.2
                    


                    

                
NuGet\Install-Package Sparkdo.ObjectExtending -Version 1.0.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Sparkdo.ObjectExtending" Version="1.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Sparkdo.ObjectExtending" Version="1.0.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Sparkdo.ObjectExtending" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Sparkdo.ObjectExtending --version 1.0.2
                    


                    

                
#r "nuget: Sparkdo.ObjectExtending, 1.0.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Sparkdo.ObjectExtending@1.0.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Sparkdo.ObjectExtending&version=1.0.2
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Sparkdo.ObjectExtending&version=1.0.2
                    


                            Install as a Cake Tool

Sparkdo.ObjectExtending

Sparkdo 对象扩展模块，提供对象属性扩展功能。

功能特性

  • 对象属性动态扩展
  • 扩展属性验证
  • 本地化扩展属性显示名称和描述
  • 与 Sparkdo 框架无缝集成

安装

<PackageReference Include="Sparkdo.ObjectExtending" Version="x.x.x" />

核心组件

ObjectExtending

  • IWithExtraProperties: 标识对象具有扩展属性的接口
  • ExtraPropertyDictionary: 扩展属性字典
  • IExtensionPropertyPolicyChecker: 扩展属性策略检查器接口
  • ExtensionPropertyPolicyChecker: 扩展属性策略检查器实现

扩展属性定义

  • ExtensionPropertyInfo: 扩展属性信息
  • ExtensionPropertyAttribute: 扩展属性特性
  • ExtensionPropertyConfiguration: 扩展属性配置

验证

  • ExtensionPropertyValidationContext: 扩展属性验证上下文
  • ExtensionPropertyValidationResult: 扩展属性验证结果

使用方法

基本对象扩展

public class MyEntity : IWithExtraProperties
{
    public ExtraPropertyDictionary ExtraProperties { get; } = new();
}

// 使用扩展属性
var entity = new MyEntity();
entity.SetProperty("CustomProperty", "CustomValue");
var value = entity.GetProperty<string>("CustomProperty");

扩展属性配置

// 配置扩展属性
var property = new ExtensionPropertyInfo(
    "CustomProperty",
    typeof(string),
    new ExtensionPropertyConfiguration
    {
        DisplayName = new FixedLocalizableString("自定义属性"),
        Description = new FixedLocalizableString("这是一个自定义属性"),
        Validators = new[]
        {
            new ExtensionPropertyValidationContext
            {
                Name = "StringLength",
                Value = 100
            }
        }
    });

扩展性

该库提供了完整的对象扩展功能实现，可以通过以下方式扩展：

  1. 实现自定义的 IExtensionPropertyPolicyChecker 来提供特定的扩展属性策略检查逻辑
  2. 实现自定义的验证逻辑来验证扩展属性
  3. 实现自定义的本地化逻辑来提供扩展属性的本地化显示

代码结构说明

本项目包含以下主要组件：

对象扩展核心

  • IWithExtraProperties: 标识对象具有扩展属性的接口
  • ExtraPropertyDictionary: 扩展属性字典实现
  • ObjectExtensionManager: 对象扩展管理器
  • ObjectExtensionPropertyInfo: 对象扩展属性信息

扩展属性策略检查

  • IExtensionPropertyPolicyChecker: 扩展属性策略检查器接口
  • ExtensionPropertyPolicyChecker: 扩展属性策略检查器实现

扩展属性定义

  • ExtensionPropertyInfo: 扩展属性信息类
  • ExtensionPropertyAttribute: 扩展属性特性
  • ExtensionPropertyConfiguration: 扩展属性配置类

验证相关

  • ExtensionPropertyValidationContext: 扩展属性验证上下文
  • ExtensionPropertyValidationResult: 扩展属性验证结果

所有公共接口和类都添加了详细的 XML 文档注释，便于开发者理解和使用。

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (10)

Showing the top 5 NuGet packages that depend on Sparkdo.ObjectExtending:

Package Downloads
Sparkdo.EventBus.Abstractions

Sparkdo 事件总线抽象库，提供事件发布/订阅模式的核心接口定义
Sparkdo.Json.SystemTextJson

Sparkdo SystemTextJson模块，提供基于System.Text.Json的JSON序列化和反序列化功能，支持自定义转换器、日期时间标准化处理、枚举序列化、扩展属性序列化等特性。
Sparkdo.TenantManagement.Domain.Shared

Sparkdo 租户管理共享资源和配置
Sparkdo.AutoMapper

Sparkdo Mapture 集成库，提供基于 Mapture 的对象映射功能实现
Sparkdo.AuditLogging.Domain.Shared

Sparkdo 审计日志共享领域层，提供审计日志模块的共享资源和常量定义

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.2 724 4/27/2026
1.0.2-preview.5 147 4/15/2026
1.0.2-preview.4 152 2/8/2026
1.0.2-preview.3 161 2/1/2026
1.0.2-preview.2 171 1/31/2026
1.0.2-preview.1 205 12/4/2025
1.0.1 2,505 11/27/2025
1.0.0 2,360 11/25/2025
1.0.0-preview.5 142 10/24/2025