Automapper C#（开发者如何使用）

Automapper 的关键特性

• 代码简化：Automapper通过自动映射属性来大幅减少手动代码的需要，从而防止错误并节省时间。
• 映射配置的灵活性：Automapper允许对映射配置进行详细定制，以适应各种映射场景。
• 性能效率：该库被设计用于处理大型和复杂的对象模型，而不会导致显著的性能开销。

通过包管理器控制台进行安装

您可以通过在包管理器控制台中执行一个简单的命令轻松在项目中安装 Automapper：

Install-Package AutoMapper

设置基本映射配置

使用 Automapper 的基础步骤是定义映射配置。 这涉及指定输入对象（源）属性应如何传输到输出对象（目标）。

var config = new MapperConfiguration(cfg => 
{
    cfg.CreateMap<SourceClass, DestinationClass>();
});
IMapper mapper = config.CreateMapper();

var config = new MapperConfiguration(cfg => 
{
    cfg.CreateMap<SourceClass, DestinationClass>();
});
IMapper mapper = config.CreateMapper();

• 在上面的例子中，创建了一个映射配置来将属性从DestinationClass。
• 使用该配置然后创建一个IMapper实例。

展平复杂的对象模型

Automapper 的一个优势是能够展平复杂的对象模型。 该功能在处理嵌套对象时特别有用，可将这些嵌套属性映射到平面目标类结构。

多样的对象类型处理

Automapper 可以熟练地在各种对象类型之间映射，包括用户域对象、DTO 甚至视图模型，为不同数据传输需求提供多样化的解决方案。

示例 1：简单映射

考虑一个需要将用户实体的属性映射到用户 DTO 的场景：

public class User
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Address { get; set; }
    public string City { get; set; }
}

public class UserDTO
{
    public string FullName { get; set; }
    public string Address { get; set; }
    public string City { get; set; }
}

// Mapping Configuration
var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<User, UserDTO>()
       .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => src.FirstName + " " + src.LastName));
});
IMapper mapper = config.CreateMapper();
User user = new User { FirstName = "John", LastName = "Doe", Address = "123 Street", City = "CityName" };
UserDTO userDto = mapper.Map<UserDTO>(user);

public class User
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string Address { get; set; }
    public string City { get; set; }
}

public class UserDTO
{
    public string FullName { get; set; }
    public string Address { get; set; }
    public string City { get; set; }
}

// Mapping Configuration
var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<User, UserDTO>()
       .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => src.FirstName + " " + src.LastName));
});
IMapper mapper = config.CreateMapper();
User user = new User { FirstName = "John", LastName = "Doe", Address = "123 Street", City = "CityName" };
UserDTO userDto = mapper.Map<UserDTO>(user);

• 该例子展示了LastName的连接。

示例 2：具有复杂对象的高级映射

在一个更复杂的场景中，让我们将具有嵌套用户详细信息的订单对象映射到简化的订单 DTO：

public class Order
{
    public User OrderedBy { get; set; }
    // Other properties...
}

public class OrderDTO
{
    public string FullName { get; set; }
    // Other properties...
}

// Mapping Configuration
var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<Order, OrderDTO>()
       .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => src.OrderedBy.FirstName + " " + src.OrderedBy.LastName));
});
IMapper mapper = config.CreateMapper();
Order order = new Order { OrderedBy = new User { FirstName = "Jane", LastName = "Doe" } };
OrderDTO orderDto = mapper.Map<OrderDTO>(order);

public class Order
{
    public User OrderedBy { get; set; }
    // Other properties...
}

public class OrderDTO
{
    public string FullName { get; set; }
    // Other properties...
}

// Mapping Configuration
var config = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<Order, OrderDTO>()
       .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => src.OrderedBy.FirstName + " " + src.OrderedBy.LastName));
});
IMapper mapper = config.CreateMapper();
Order order = new Order { OrderedBy = new User { FirstName = "Jane", LastName = "Doe" } };
OrderDTO orderDto = mapper.Map<OrderDTO>(order);

• 该例子演示了从一个包含嵌套FullName属性。

自9.0版本起，AutoMapper从静态API (Mapper.Initialize) 转变为基于实例的API。 这一变化增强了灵活性，更适合现代应用程序，尤其是那些使用依赖注入的应用程序。 如果您使用的版本早于 9.0，可继续使用静态 API 方式。 然而，对于较新的版本，建议如上面的例子中采用基于实例的 API。

Iron Software 套件的关键组件

1. IronPDF for PDF Management：该组件允许开发者创建、读取、编辑和签署 PDF。 它也提供将 HTML 转换为 PDF 的能力，这在从基于网页的数据生成报告或文档时尤为有用。

   

2. IronXL Excel File Handling：IronXL 使处理 Excel 文件无需依赖 Office Interop，简化了数据处理和分析任务。

   

3. IronOCR for Text Extraction：它支持从图像中提取文本，支持多达 125 种语言，是国际项目的高性价比选择。

   

4. IronBarcode for QR and Barcode Support：一个允许读取和编写 QR 码和条形码的库，提高了库存管理、跟踪以及其他相关任务的能力。

与 Automapper 的互补性

虽然Automapper在C#中出色地映射不同对象模型之间的属性，Iron Software的库通过提供处理各种数据格式和类型的工具扩展了功能。例如，在使用Automapper将用户域对象转换为DTO之后，可以使用IronPDF生成PDF格式的综合报告。 同样，通过 Automapper 提取或转换的数据可以使用 IronXL 进行进一步的操作或分析以处理 Excel 文件。