/// <summary>
/// 添加将对象从 <typeparamref name="TInput"/> 类型转换为 <typeparamref name="TOutput"/> 类型的转换器。
/// </summary>
/// <typeparam name="TInput">输入对象的类型。</typeparam>
/// <typeparam name="TOutput">输出对象的类型。</typeparam>
/// <param name="converter">将对象从 <typeparamref name="TInput"/> 类型转换为
/// <typeparamref name="TOutput"/> 类型的转换器。</param>
/// <exception cref="ArgumentNullException"><paramref name="converter"/> 为 <c>null</c>。</exception>
/// <remarks><paramref name="converter"/> 不会覆盖预定义的隐式、显式类型转换和用户自定义的类型转换。
/// 对于相同输入/输出类型的 <paramref name="converter"/>，后设置的会覆盖先设置的，以及任何
/// <see cref="IConverterProvider"/> 提供的类型转换方法。</remarks>
public static void AddConverter <TInput, TOutput>(Converter <TInput, TOutput> converter)
{
CommonExceptions.CheckArgumentNull(converter, "converter");
Contract.EndContractBlock();
ConversionFactory.AddConverterProvider(new ConverterProvider(converter, typeof(TInput), typeof(TOutput)));
}
/// <summary>
/// 基于指定的判据，从给定的属性集中选择一个属性。
/// </summary>
/// <param name="bindingAttr"><see cref="System.Reflection.BindingFlags"/> 值的按位组合。</param>
/// <param name="match">用于匹配的候选属性集。</param>
/// <param name="returnType">匹配属性必须具有的返回值。</param>
/// <param name="indexes">所搜索的属性的索引类型。</param>
/// <param name="modifiers">使绑定能够处理在其中修改了类型的参数签名的参数修饰符数组。</param>
/// <returns>如果找到，则为匹配的属性；否则为 <c>null</c>。</returns>
public override PropertyInfo SelectProperty(BindingFlags bindingAttr, PropertyInfo[] match, Type returnType,
Type[] indexes, ParameterModifier[] modifiers)
{
CommonExceptions.CheckArgumentNull(match, "match");
if (match.Length == 0)
{
return(null);
}
int idxLen = indexes == null ? 0 : indexes.Length;
// 构造属性信息数组。
MatchInfo[] infos = new MatchInfo[match.Length];
int idx = 0;
for (int i = 0; i < match.Length; i++)
{
if (match[i] != null)
{
ParameterInfo[] parameters = match[i].GetIndexParameters();
// 匹配属性类型与索引参数。
if (parameters.Length == idxLen && CheckParameters(infos[i], indexes, idxLen) &&
CanChangeType(match[i].PropertyType, returnType))
{
infos[idx] = new MatchInfo(parameters, MethodExt.GetParamOrder(idxLen));
match[idx] = match[i];
idx++;
}
}
}
if (idx == 0)
{
return(null);
}
if (idx == 1)
{
return(match[0]);
}
// 多个可匹配属性，寻找匹配的最好的属性。
int min = 0;
bool ambig = false;
for (int i = 1; i < idx; i++)
{
// 先比较属性类型。
int cmp = FindMostSpecificType(match[min].PropertyType, match[i].PropertyType, returnType);
if (cmp == 0 && indexes != null)
{
// 再比较属性参数。
cmp = FindMostSpecific(infos[min], infos[i], indexes);
}
if (cmp == 0)
{
// 最后比较定义的层级深度。
cmp = CompareHierarchyDepth(match[min], match[i]);
if (cmp == 0)
{
ambig = true;
}
}
if (cmp == 2)
{
ambig = false;
min = i;
}
}
if (ambig)
{
throw CommonExceptions.AmbiguousMatchProperty();
}
return(match[min]);
}