一、最簡單的用法
有兩個類User和UserDto
1 public class User2 {3 public int Id { get; set; }4 public string Name { get; set; }5 public int Age { get; set; }6 }7 8 public class UserDto9 {
10 public string Name { get; set; }
11 public int Age { get; set; }
12 } 將User轉換成UserDto也和簡單
1 Mapper.Initialize(x => x.CreateMap<User, UserDto>());
2 User user = new User()
3 {
4 Id = 1,
5 Name = "caoyc",
6 Age = 20
7 };
8 var dto = Mapper.Map<UserDto>(user); ?這是一種最簡單的使用，AutoMapper會更加字段名稱去自動對于，忽略大小寫。
?
二、如果屬性名稱不同
將UserDto的Name屬性改成Name2
1 Mapper.Initialize(x => 2 x.CreateMap<User, UserDto>()3 .ForMember(d =>d.Name2, opt => {4 opt.MapFrom(s => s.Name);5 })6 );7 8 User user = new User()9 {
10 Id = 1,
11 Name = "caoyc",
12 Age = 20
13 };
14
15 var dto = Mapper.Map<UserDto>(user); 
?
三、使用Profile配置
自定義一個UserProfile類繼承Profile，并重寫Configure方法
1 public class UserProfile : Profile2 {3 protected override void Configure()4 {5 CreateMap<User, UserDto>()6 .ForMember(d => d.Name2, opt =>7 {8 opt.MapFrom(s => s.Name);9 });
10 }
11 } 使用時就這樣
1 Mapper.Initialize(x => x.AddProfile<UserProfile>());2 3 User user = new User()4 {5 Id = 1,6 Name = "caoyc",7 Age = 208 };9
10 var dto = Mapper.Map<UserDto>(user); ?
四、空值替換NullSubstitute
空值替換允許我們將Source對象中的空值在轉換為Destination的值的時候，使用指定的值來替換空值。
1 public class UserProfile : Profile2 {3 protected override void Configure()4 {5 CreateMap<User, UserDto>()6 .ForMember(d => d.Name2, opt => opt.MapFrom(s => s.Name))7 .ForMember(d => d.Name2, opt => opt.NullSubstitute("值為空"));8 9 }
10 } 1 Mapper.Initialize(x => x.AddProfile<UserProfile>());
2
3 User user = new User()
4 {
5 Id = 1,
6 Age = 20
7 };
8
9 var dto = Mapper.Map<UserDto>(user); 結果為：
?
五、忽略屬性Ignore
1 public class User2 {3 public int Id { get; set; }4 public string Name { get; set; }5 public int Age { get; set; }6 }7 8 public class UserDto9 {
10 public string Name { get; set; }
11 public int Age { get; set; }
12
13 }
14
15 public class UserProfile : Profile
16 {
17 protected override void Configure()
18 {
19 CreateMap<User, UserDto>().ForMember("Name", opt => opt.Ignore());
20 }
21 } 使用
1 Mapper.Initialize(x => x.AddProfile<UserProfile>());2 3 User user = new User()4 {5 Id = 1,6 Name="caoyc",7 Age = 208 };9
10 var dto = Mapper.Map<UserDto>(user); 結果：
?
六、預設值
如果目標屬性多于源屬性，可以進行預設值
1 public class User2 {3 public int Id { get; set; }4 public string Name { get; set; }5 public int Age { get; set; }6 }7 8 public class UserDto9 {
10 public string Name { get; set; }
11 public int Age { get; set; }
12 public string Gender { get; set; }
13
14 }
15
16 public class UserProfile : Profile
17 {
18 protected override void Configure()
19 {
20 CreateMap<User, UserDto>();
21 }
22 } 使用
1 Mapper.Initialize(x => x.AddProfile<UserProfile>());2 3 User user = new User()4 {5 Id = 1,6 Name="caoyc",7 Age = 208 };9
10 UserDto dto = new UserDto() {Gender = "男"};
11 Mapper.Map(user, dto); 
?七、類型轉換ITypeConverter
如果數據中Gender存儲的int類型，而DTO中Gender是String類型
1 public class User
2 {
3 public int Gender { get; set; }
4 }
5
6 public class UserDto
7 {
8 public string Gender { get; set; }
9 } 類型轉換類，需要實現接口ITypeConverter
1 public class GenderTypeConvertert : ITypeConverter<int, string>2 {3 public string Convert(int source, string destination, ResolutionContext context)4 {5 switch (source)6 {7 case 0:8 destination = "男";9 break;
10 case 1:
11 destination = "女";
12 break;
13 default:
14 destination = "未知";
15 break;
16 }
17 return destination;
18 }
19 } 配置規則
1 public class UserProfile : Profile2 {3 protected override void Configure()4 {5 CreateMap<User, UserDto>();6 7 CreateMap<int, string>().ConvertUsing<GenderTypeConvertert>();8 //也可以寫這樣9 //CreateMap<int, string>().ConvertUsing(new GenderTypeConvertert());
10 }
11 } 使用
1 Mapper.Initialize(x => x.AddProfile<UserProfile>());2 3 User user0 = new User() { Gender = 0 };4 User user1 = new User() { Gender = 1 };5 User user2 = new User() { Gender = 2 };6 var dto0= Mapper.Map<UserDto>(user0);7 var dto1 = Mapper.Map<UserDto>(user1);8 var dto2 = Mapper.Map<UserDto>(user2);9
10 Console.WriteLine("dto0:{0}", dto0.Gender);
11 Console.WriteLine("dto1:{0}", dto1.Gender);
12 Console.WriteLine("dto2:{0}", dto2.Gender); 結果
?
八、條件約束Condition
當滿足條件時才進行映射字段，例如人類年齡，假設我們現在人類年齡范圍為0-200歲（這只是假設），只有滿足在這個條件才進行映射
DTO和Entity
1 public class User
2 {
3 public int Age { get; set; }
4 }
5
6 public class UserDto
7 {
8 public int Age { get; set; }
9 } Profile
1 public class UserProfile : Profile
2 {
3 protected override void Configure()
4 {
5 CreateMap<User, UserDto>().ForMember(dest=>dest.Age,opt=>opt.Condition(src=>src.Age>=0 && src.Age<=200));
6 }
7 } 使用代碼
1 Mapper.Initialize(x => x.AddProfile<UserProfile>());2 3 User user0 = new User() { Age = 1 };4 User user1 = new User() { Age = 150 };5 User user2 = new User() { Age = 201 };6 var dto0= Mapper.Map<UserDto>(user0);7 var dto1 = Mapper.Map<UserDto>(user1);8 var dto2 = Mapper.Map<UserDto>(user2);9
10 Console.WriteLine("dto0:{0}", dto0.Age);
11 Console.WriteLine("dto1:{0}", dto1.Age);
12 Console.WriteLine("dto2:{0}", dto2.Age); 輸出結果
?
?
using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; using AutoMapper; using System.Data; namespace ConsoleApplication2 { class Program { static void Main(string[] args) { //1.普通轉換 Name name1 = new Name() { FirstName = "L", LastName = "jz" }; Mapper.CreateMap<Name, NameDto>() .BeforeMap((name, nameDto) => Console.WriteLine("hello world before")) .AfterMap((name, nameDto) => Console.WriteLine("hello world after")); NameDto nameDto1 = Mapper.Map<Name, NameDto>(name1); Console.WriteLine("1"); Console.WriteLine(nameDto1.FirstName + nameDto1.LastName); Console.WriteLine(); //Console.ReadKey(); //整體設置 //2.整體即時轉換 Mapper.Reset(); Name name2 = new Name() { FirstName = "L", LastName = "jz" }; Mapper.CreateMap<Name, NameDto>() .ConstructUsing(name => new NameDto() { AllName = name.FirstName + name.LastName }); NameDto nameDto2 = Mapper.Map<Name, NameDto>(name2); Console.WriteLine("2"); Console.WriteLine(nameDto2.AllName); Console.WriteLine(); //Console.ReadKey(); //3.整體通過TypeConverter類型轉換 Mapper.Reset(); Name name3 = new Name() { FirstName = "L", LastName = "jz" }; Mapper.CreateMap<Name, NameDto>() .ConvertUsing<NameConverter>(); NameDto nameDto3 = Mapper.Map<Name, NameDto>(name3); Console.WriteLine("3"); Console.WriteLine(nameDto3.AllName); Console.WriteLine(); //Console.ReadKey(); //單屬性設置 //4.屬性條件轉換 Mapper.Reset(); Name name4 = new Name() { FirstName = "L", LastName = "jz" }; Mapper.CreateMap<Name, NameDto>() .ForMember(name => name.FirstName, opt => opt.Condition(name => !name.FirstName.Equals("l", StringComparison.OrdinalIgnoreCase))); NameDto nameDto4 = Mapper.Map<Name, NameDto>(name4); Console.WriteLine("4"); Console.WriteLine(string.IsNullOrEmpty(nameDto4.FirstName)); Console.WriteLine(); //Console.ReadKey(); //5.屬性忽略 Mapper.Reset(); Name name5 = new Name() { FirstName = "L", LastName = "jz" }; Mapper.CreateMap<Name, NameDto>() .ForMember(name => name.FirstName, opt => opt.Ignore()); NameDto nameDto5 = Mapper.Map<Name, NameDto>(name5); Console.WriteLine("5"); Console.WriteLine(string.IsNullOrEmpty(nameDto5.FirstName)); Console.WriteLine(); //Console.ReadKey(); //6.屬性轉換 Mapper.Reset(); Name name6 = new Name() { FirstName = "L", LastName = "jz" }; Mapper.CreateMap<Name, NameDto>() .ForMember(name => name.AllName, opt => opt.MapFrom(name => name.FirstName + name.LastName)) .ForMember(name => name.FirstName, opt => opt.MapFrom(name=>name.FirstName)); NameDto nameDto6 = Mapper.Map<Name, NameDto>(name6); Console.WriteLine("6"); Console.WriteLine(nameDto6.AllName); Console.WriteLine(); //Console.ReadKey(); //7.屬性通過ValueResolver轉換 Mapper.Reset(); Name name7 = new Name() { FirstName = "L", LastName = "jz" }; Mapper.CreateMap<Name, StoreDto>() .ForMember(storeDto => storeDto.Name, opt => opt.ResolveUsing<NameResolver>()); StoreDto store1 = Mapper.Map<Name, StoreDto>(name7); Console.WriteLine("7"); Console.WriteLine(store1.Name.FirstName + store1.Name.LastName); Console.WriteLine(); //Console.ReadKey(); //8.屬性填充固定值 Mapper.Reset(); Name name8 = new Name() { FirstName = "L", LastName = "jz" }; Mapper.CreateMap<Name, NameDto>() .ForMember(name => name.AllName, opt => opt.UseValue<string>("ljzforever")); NameDto nameDto8 = Mapper.Map<Name, NameDto>(name8); Console.WriteLine("8"); Console.WriteLine(nameDto8.AllName); Console.WriteLine(); //Console.ReadKey(); //9.屬性格式化 Mapper.Reset(); Name name9 = new Name() { FirstName = "L", LastName = "jz" }; Mapper.CreateMap<Name, NameDto>() .ForMember(name => name.FirstName, opt => opt.AddFormatter<StringFormatter>()); NameDto nameDto9 = Mapper.Map<Name, NameDto>(name9); Console.WriteLine("9"); Console.WriteLine(nameDto9.FirstName); Console.WriteLine(); //Console.ReadKey(); //10.屬性null時的默認值 Mapper.Reset(); Name name10 = new Name() { FirstName = "L" }; Mapper.CreateMap<Name, NameDto>() .ForMember(name => name.LastName, opt => opt.NullSubstitute("jz")); NameDto nameDto10 = Mapper.Map<Name, NameDto>(name10); Console.WriteLine("10"); Console.WriteLine(nameDto10.LastName); Console.WriteLine(); //Console.ReadKey(); //其它設置與特性 //11.轉換匿名對象 Mapper.Reset(); object name11 = new { FirstName = "L", LastName = "jz" }; NameDto nameDto11 = Mapper.DynamicMap<NameDto>(name11); Console.WriteLine("11"); Console.WriteLine(nameDto11.FirstName + nameDto11.LastName); Console.WriteLine(); //Console.ReadKey(); //12.轉換DataTable Mapper.Reset(); DataTable dt = new DataTable(); dt.Columns.Add("FirstName", typeof(string)); dt.Columns.Add("LastName", typeof(string)); dt.Rows.Add("L", "jz"); List<NameDto> nameDto12 = Mapper.DynamicMap<IDataReader, List<NameDto>>(dt.CreateDataReader()); Console.WriteLine("12"); Console.WriteLine(nameDto12[0].FirstName + nameDto12[0].LastName); Console.WriteLine(); //Console.ReadKey(); //emitMapper error //List<NameDto> nameDto20 = EmitMapper.ObjectMapperManager.DefaultInstance.GetMapper<IDataReader, List<NameDto>>().Map(dt.CreateDataReader()); //13.轉化存在的對象 Mapper.Reset(); Mapper.CreateMap<Name, NameDto>() .ForMember(name => name.LastName, opt => opt.Ignore()); Name name13 = new Name() { FirstName = "L" }; NameDto nameDto13 = new NameDto() { LastName = "jz" }; Mapper.Map<Name, NameDto>(name13, nameDto13); //nameDto13 = Mapper.Map<Name, NameDto>(name13);//注意,必需使用上面的寫法,不然nameDto13對象的LastName屬性會被覆蓋 Console.WriteLine("13"); Console.WriteLine(nameDto13.FirstName + nameDto13.LastName); Console.WriteLine(); //Console.ReadKey(); //14.Flatten特性 Store.Name.FirtName=FlattenName.NameFirstname Mapper.Reset(); Mapper.CreateMap<Store, FlattenName>(); Store store2 = new Store() { Name = new Name() { FirstName = "L", LastName = "jz" } }; FlattenName nameDto14 = Mapper.Map<Store, FlattenName>(store2); Console.WriteLine("14"); Console.WriteLine(nameDto14.NameFirstname + nameDto14.NameLastName); Console.WriteLine(); //Console.ReadKey(); //15.將Dictionary轉化為對象,現在還不支持 Mapper.Reset(); Mapper.CreateMap<Dictionary<string, object>, Name>(); Dictionary<string, object> dict = new Dictionary<string, object>(); dict.Add("FirstName", "L"); //Name name15 = Mapper.DynamicMap<Dictionary<string, object>, Name>(dict); Name name15 = Mapper.Map<Dictionary<string, object>, Name>(dict); Console.WriteLine("15"); Console.WriteLine(name15.FirstName); Console.WriteLine(); Console.ReadKey(); } } public class Store { public Name Name { get; set; } public int Age { get; set; } } public class Name { public string FirstName { get; set; } public string LastName { get; set; } } public class StoreDto { public NameDto Name { get; set; } public int Age { get; set; } } public class NameDto { public string FirstName { get; set; } public string LastName { get; set; } public string AllName { get; set; } } public class FlattenName { public string NameFirstname { get; set; } public string NameLastName { get; set; } } public class NameConverter : TypeConverter<Name, NameDto> { protected override NameDto ConvertCore(Name source) { return new NameDto() { AllName = source.FirstName + source.LastName }; } } public class NameResolver : ValueResolver<Name, NameDto> { protected override NameDto ResolveCore(Name source) { return new NameDto() { FirstName = source.FirstName, LastName = source.LastName,AllName=source.FirstName+source.LastName }; } } public class NameFormatter : ValueFormatter<NameDto> { protected override string FormatValueCore(NameDto name) { return name.FirstName + name.LastName; } } public class StringFormatter : ValueFormatter<string> { protected override string FormatValueCore(string name) { return name + "-"; } } }
?
