Sparkdo.AutoMapper 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.AutoMapper --version 1.0.2
                    


                    

                
NuGet\Install-Package Sparkdo.AutoMapper -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.AutoMapper" Version="1.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Sparkdo.AutoMapper" Version="1.0.2" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Sparkdo.AutoMapper" />
                    


                            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.AutoMapper --version 1.0.2
                    


                    

                
#r "nuget: Sparkdo.AutoMapper, 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.AutoMapper@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.AutoMapper&version=1.0.2
                    


                            Install as a Cake Addin
                        

                    

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


                            Install as a Cake Tool

Sparkdo.Mapture

Sparkdo Mapture 集成库，提供基于 Mapture 的对象映射功能实现。

功能特性

  • 基于 Mapture 的对象映射实现
  • 支持扩展属性映射
  • 支持忽略扩展属性映射
  • 支持忽略审计属性映射 (Creation, Modification, Deletion, Full Audited)
  • 与 Sparkdo 框架无缝集成
  • 支持依赖注入配置

安装

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

核心组件

MaptureAutoObjectMappingProvider

Mapture 自动对象映射提供者，实现 IAutoObjectMappingProvider 接口：

  • Map<TSource, TDestination>(object source): 映射对象
  • Map<TSource, TDestination>(TSource source, TDestination destination): 映射到现有对象

扩展方法

SparkdoMaptureExtensibleObjectExtensions

为扩展属性提供映射支持：

  • MapExtraProperties<TSource, TDestination>(): 映射扩展属性
  • IgnoreExtraProperties<TSource, TDestination>(): 忽略扩展属性映射
MaptureServiceCollectionExtensions

IServiceCollection 扩展方法：

  • AddMaptureObjectMapper(): 添加 Mapture 对象映射器
  • AddMaptureObjectMapper<TContext>(): 添加支持特定上下文的 Mapture 对象映射器
SparkdoMaptureObjectMapperExtensions

IObjectMapper 扩展方法：

  • GetMapper(): 获取 Mapture IMapper 实例
MaptureExpressionExtensions

提供针对审计属性的映射忽略扩展：

  • IgnoreCreationAuditedObjectProperties(): 忽略创建审计属性
  • IgnoreModificationAuditedObjectProperties(): 忽略修改审计属性
  • IgnoreDeletionAuditedObjectProperties(): 忽略删除审计属性
  • IgnoreFullAuditedObjectProperties(): 忽略完整审计属性

使用方法

基本配置

在模块的 ConfigureServices 方法中添加 Mapture 配置：

public override void ConfigureServices(IServiceCollection services)
{
    services.AddMaptureObjectMapper();
}

对象映射

使用 Mapture 进行对象映射：

// 简单对象映射
var destination = objectMapper.Map<SourceObject, DestinationObject>(source);

// 映射到现有对象
objectMapper.Map<SourceObject, DestinationObject>(source, existingDestination);

扩展属性映射

在 Mapture 配置中映射扩展属性：

CreateMap<SourceEntity, DestinationEntity>()
    .MapExtraProperties();

忽略审计属性

在 Mapture 配置中忽略审计属性：

CreateMap<SourceEntity, DestinationEntity>()
    .IgnoreFullAuditedObjectProperties();

扩展性

该库提供了完整的 Mapture 集成功能，可以通过以下方式扩展：

  1. 实现自定义的 IAutoObjectMappingProvider 来替换底层映射实现
  2. 通过继承 MaptureAutoObjectMappingProvider<TContext> 来添加上下文支持
  3. 使用 Mapture 的配置 API 自定义映射规则

代码结构说明

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

映射提供者

  • MaptureAutoObjectMappingProvider: 基于 Mapture 的自动对象映射提供者
  • MaptureAutoObjectMappingProvider<TContext>: 支持特定上下文的 Mapture 自动对象映射提供者

配置相关

  • IMapperConfigurationFactory: 配置提供者工厂接口
  • MapperConfigurationFactory: 配置提供者工厂实现
  • ISparkdoMaptureConfigurationContext: Mapture 配置上下文接口
  • SparkdoMaptureConfigurationContext: Mapture 配置上下文实现
  • SparkdoMaptureOptions: Mapture 配置选项

扩展方法

  • SparkdoMaptureExtensibleObjectExtensions: 扩展属性映射扩展方法
  • MaptureServiceCollectionExtensions: 服务集合扩展方法
  • SparkdoMaptureObjectMapperExtensions: 对象映射器扩展方法
  • MaptureExpressionExtensions: Mapture 表达式扩展方法

模块配置

  • SparkdoMaptureModule: Sparkdo Mapture 模块配置

所有公共接口和类都添加了详细的 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

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.2 88 4/27/2026
1.0.2-preview.5 46 4/15/2026
1.0.2-preview.4 65 2/8/2026
1.0.2-preview.3 63 2/1/2026
1.0.2-preview.2 60 1/31/2026
1.0.2-preview.1 177 12/4/2025
1.0.1 235 11/27/2025
1.0.0 208 11/25/2025
1.0.0-preview.5 133 10/24/2025