AutoMapper官方文档(十一)【自定义类型转换器】

有时候，你需要完全控制一种类型到另一种类型的转换。这通常是当一个类型看起来不像另一个类型时，转换函数已经存在，并且您希望从

“松散”

类型转换为更强类型，比如源类型的字符串到目标类型

Int32

。

例如，假设我们有一个来源类型：

public class Source
{
public string Value1 { get; set; }
public string Value2 { get; set; }
public string Value3 { get; set; }
}

但是你想把它映射到:

public class Destination
{
public int Value1 { get; set; }
public DateTime Value2 { get; set; }
public Type Value3 { get; set; }
}

如果我们试图将这两个类型按原样映射，

AutoMapper

将会抛出一个异常(在映射时间和配置检查时间)，因为

AutoMapper

不知道从

string

到

int

，

DateTime

或

Type

的映射。 为了创建这些类型的映射，我们必须提供一个自定义的类型转换器，我们有三种方法：

void ConvertUsing(Func<TSource, TDestination> mappingFunction);
void ConvertUsing(ITypeConverter<TSource, TDestination> converter);
void ConvertUsing<TTypeConverter>() where TTypeConverter : ITypeConverter<TSource, TDestination>;

第一个选项就是任何一个接受一个源并返回一个目标的函数（也有几个重载）。 这适用于简单的情况，但对于较大的情况变得笨重。 在更困难的情况下，我们可以创建一个自定义的

ITypeConverter<TSource, TDestination>

：

public interface ITypeConverter<in TSource, TDestination>
{
TDestination Convert(TSource source, TDestination destination, ResolutionContext context);
}

并为

AutoMapper

提供一个自定义类型转换器的实例，或者简单的

AutoMapper

将在运行时实例化的类型。 我们上面的源/目标类型的映射配置然后变成：

[Test]
public void Example()
{
Mapper.Initialize(cfg => {
cfg.CreateMap<string, int>().ConvertUsing(s => Convert.ToInt32(s));
cfg.CreateMap<string, DateTime>().ConvertUsing(new DateTimeTypeConverter());
cfg.CreateMap<string, Type>().ConvertUsing<TypeTypeConverter>();
cfg.CreateMap<Source, Destination>();
});
Mapper.AssertConfigurationIsValid();

var source = new Source
{
Value1 = "5",
Value2 = "01/01/2000",
Value3 = "AutoMapperSamples.GlobalTypeConverters.GlobalTypeConverters+Destination"
};

Destination result = Mapper.Map<Source, Destination>(source);
result.Value3.ShouldEqual(typeof(Destination));
}

public class DateTimeTypeConverter : ITypeConverter<string, DateTime>
{
public DateTime Convert(string source, DateTime destination, ResolutionContext context)
{
return System.Convert.ToDateTime(source);
}
}

public class TypeTypeConverter : ITypeConverter<string, Type>
{
public Type Convert(string source, Type destination, ResolutionContext context)
{
return Assembly.GetExecutingAssembly().GetType(source);
}
}

在第一个映射中，从

string

到

Int32

，我们只需使用内置的

Convert.ToInt32

函数（作为方法组提供）。 接下来的两个使用自定义的

ITypeConverter

实现。

自定义类型转换器的真正威力在于

AutoMapper

在任何映射类型上找到源/目标对时都可以使用它们。 我们可以构建一套自定义类型转换器，在其他映射配置上使用，而不需要任何额外的配置。 在上面的例子中，我们再也不需要指定

string/int

转换。 在自定义值解析器必须在类型成员级别配置的情况下，自定义类型转换器是全局范围的。

系统类型转换器

.NET Framework

还通过

TypeConverter

类支持类型转换器的概念。

AutoMapper

支持这些类型的转换器，进行配置检查和映射，而不需要任何手动配置。 AutoMapper使用

TypeDescriptor.GetConverter

方法来确定是否可以映射源/目标类型对。