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可以熟練地在各種物件類型之間進行映射，包括使用者領域物件、DTOs，甚至是視圖模型，為不同的資料傳輸需求提供多元化的解決方案。

範例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 Suite的關鍵組成部分

1. IronPDF for PDF Management：此組件允許開發者創建、閱讀、編輯和簽署PDF。 它還提供將HTML轉換為 PDF 的功能，這在從基於網頁的資料生成報告或文件時特別有用。

   

2. IronXL Excel File Handling：IronXL可在不需要Office Interop的情況下處理Excel文件，簡化資料操作和分析任務。

   

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文件操作。