Sparkdo.ObjectMapping
1.0.2
dotnet add package Sparkdo.ObjectMapping --version 1.0.2
NuGet\Install-Package Sparkdo.ObjectMapping -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.ObjectMapping" Version="1.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Sparkdo.ObjectMapping" Version="1.0.2" />
<PackageReference Include="Sparkdo.ObjectMapping" />
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.ObjectMapping --version 1.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Sparkdo.ObjectMapping, 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.ObjectMapping@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.ObjectMapping&version=1.0.2
#tool nuget:?package=Sparkdo.ObjectMapping&version=1.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Sparkdo.ObjectMapping
Sparkdo 对象映射库，提供对象到对象的自动映射功能实现。
功能特性
- 支持自动对象映射
- 支持集合类型映射
- 支持自定义映射器
- 支持映射上下文
- 与 Sparkdo 框架无缝集成
安装
<PackageReference Include="Sparkdo.ObjectMapping" Version="x.x.x" />
核心组件
IObjectMapper
对象映射器接口，提供基本的对象映射功能：
Map<TSource, TDestination>(TSource source): 将源对象映射到新目标对象Map<TSource, TDestination>(TSource source, TDestination destination): 将源对象映射到现有目标对象
DefaultObjectMapper
默认对象映射器实现，提供完整的对象映射功能：
- 自动映射简单对象和复杂对象
- 支持集合类型映射（List, Array, Collection等）
- 支持自定义映射器注入
- 支持映射上下文
IAutoObjectMappingProvider
自动对象映射提供者接口，负责底层的自动映射实现：
Map<TSource, TDestination>(object source): 映射对象Map<TSource, TDestination>(TSource source, TDestination destination): 映射到现有对象
扩展接口
IObjectMapper<TContext>: 支持特定上下文的对象映射器IObjectMapper<TSource, TDestination>: 特定类型对象映射器IMapFrom<TSource>: 从源类型映射的接口IMapTo<TDestination>: 映射到目标类型的接口
扩展性
该库提供了完整的对象映射功能实现，可以通过以下方式扩展：
- 实现自定义的
IObjectMapper<TSource, TDestination>来添加特定类型的映射逻辑 - 实现自定义的
IAutoObjectMappingProvider来替换底层映射实现 - 通过继承
DefaultObjectMapper<TContext>来添加上下文支持
代码结构说明
本项目包含以下主要组件：
映射器接口
IObjectMapper: 基本对象映射器接口IObjectMapper<TContext>: 支持上下文的对象映射器接口IObjectMapper<TSource, TDestination>: 特定类型对象映射器接口
映射器实现
DefaultObjectMapper: 默认对象映射器实现DefaultObjectMapper<TContext>: 支持上下文的默认对象映射器实现
自动映射提供者
IAutoObjectMappingProvider: 自动对象映射提供者接口IAutoObjectMappingProvider<TContext>: 支持上下文的自动对象映射提供者接口NotImplementedAutoObjectMappingProvider: 未实现的自动对象映射提供者
扩展接口
IMapFrom<TSource>: 从源类型映射的接口IMapTo<TDestination>: 映射到目标类型的接口
扩展方法
ObjectMapperExtensions: 对象映射器扩展方法
模块配置
SparkdoObjectMappingModule: Sparkdo 对象映射模块配置
所有公共接口和类都添加了详细的 XML 文档注释，便于开发者理解和使用。
| Product | Versions 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.
-
net10.0
- JetBrains.Annotations (>= 2025.2.4)
- Microsoft.Extensions.Configuration (>= 10.0.5)
- Microsoft.Extensions.Configuration.CommandLine (>= 10.0.5)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.5)
- Microsoft.Extensions.Configuration.FileExtensions (>= 10.0.5)
- Microsoft.Extensions.Configuration.Json (>= 10.0.5)
- Microsoft.Extensions.Configuration.UserSecrets (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.5)
- Microsoft.Extensions.DependencyModel (>= 10.0.5)
- Microsoft.Extensions.FileProviders.Physical (>= 10.0.5)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Localization (>= 10.0.5)
- Microsoft.Extensions.Logging (>= 10.0.5)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Options (>= 10.0.5)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.5)
- Microsoft.Extensions.Options.DataAnnotations (>= 10.0.5)
- Nito.AsyncEx.Context (>= 5.1.2)
- Sparkdo.Core (>= 1.0.2)
- System.Linq.Dynamic.Core (>= 1.7.1)
NuGet packages (3)
Showing the top 3 NuGet packages that depend on Sparkdo.ObjectMapping:
| Package | Downloads |
|---|---|
|
Sparkdo.Ddd.Domain
Sparkdo DDD 领域模型库，提供领域驱动设计的核心组件实现 |
|
|
Sparkdo.AutoMapper
Sparkdo Mapture 集成库，提供基于 Mapture 的对象映射功能实现 |
|
|
Sparkdo.Mapperly
Sparkdo Mapperly 集成库，提供基于 Mapperly 的对象映射功能实现 |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.2 | 297 | 4/27/2026 |
| 1.0.2-preview.5 | 83 | 4/15/2026 |
| 1.0.2-preview.4 | 90 | 2/8/2026 |
| 1.0.2-preview.3 | 100 | 2/1/2026 |
| 1.0.2-preview.2 | 108 | 1/31/2026 |
| 1.0.2-preview.1 | 188 | 12/4/2025 |
| 1.0.1 | 872 | 11/27/2025 |
| 1.0.0 | 832 | 11/25/2025 |
| 1.0.0-preview.5 | 134 | 10/24/2025 |