/// <summary> /// 基于参数类型,从给定的方法集中选择一个方法。 /// 允许通过指定 <see cref="BindingFlags.OptionalParamBinding"/> 来匹配可选参数。 /// </summary> /// <param name="bindingAttr"><see cref="BindingFlags"/> 值的按位组合。</param> /// <param name="match">用于匹配的候选方法集。</param> /// <param name="types">用于定位匹配方法的参数类型。</param> /// <param name="modifiers">使绑定能够处理在其中修改了类型的参数签名的参数修饰符数组。</param> /// <returns>如果找到,则为匹配的方法;否则为 <c>null</c>。</returns> /// <exception cref="ArgumentNullException"><paramref name="match"/> 为 <c>null</c>。</exception> /// <exception cref="ArgumentNullException"><paramref name="types"/> 为 <c>null</c>。</exception> /// <exception cref="ArgumentException"><paramref name="match"/> 为空数组。</exception> /// <exception cref="ArgumentException"><paramref name="match"/> 中包含为 <c>null</c> 的元素。</exception> /// <exception cref="AmbiguousMatchException"><paramref name="match"/> 包含多个与 <paramref name="types"/> /// 匹配程度相同的方法。</exception> /// <remarks>此方法支持可选参数,可以通过为参数类型指定 <see cref="Missing"/> 来表示使用可选参数。 /// 或者为 <paramref name="bindingAttr"/> 设置 <see cref="BindingFlags.InvokeMethod"/>、 /// <see cref="BindingFlags.CreateInstance"/>、<see cref="BindingFlags.GetProperty"/> 或 /// <see cref="BindingFlags.SetProperty"/> 之一,就可以直接省略掉可选参数对应的类型。</remarks> public override MethodBase SelectMethod(BindingFlags bindingAttr, MethodBase[] match, Type[] types, ParameterModifier[] modifiers) { CommonExceptions.CheckCollectionItemNull(match, "match"); CommonExceptions.CheckArgumentNull(types, "types"); Contract.EndContractBlock(); MethodArgumentsOption options = MethodArgumentsOption.None; if (isExplicit) { options |= MethodArgumentsOption.Explicit; } if (bindingAttr.HasFlag(BindingFlags.OptionalParamBinding)) { options |= MethodArgumentsOption.OptionalParamBinding; } MethodMatchInfo[] infos = new MethodMatchInfo[match.Length]; MethodMatchInfo info; int length = 0; for (int i = 0; i < match.Length; i++) { info = MethodMatchInfo.GetMatchInfo(match[i], types, null, options); if (info != null) { infos[length++] = info; } } info = SelectMethod(infos, length, types); return(info == null ? null : info.Method); }
/// <summary> /// 基于指定的判据,从给定的字段集中选择一个字段。 /// </summary> /// <param name="bindingAttr"><see cref="BindingFlags"/> 值的按位组合。</param> /// <param name="match">用于匹配的候选字段集。<see cref="PowerBinder"/> 的实现会更改此数组的顺序。</param> /// <param name="value">用于定位匹配字段的字段值。</param> /// <param name="culture">一个 <see cref="CultureInfo"/> 实例, /// 用于在强制类型的联编程序实现中控制数据类型强制。</param> /// <returns>匹配的字段。</returns> /// <exception cref="ArgumentNullException"><paramref name="match"/> 为 <c>null</c>。</exception> /// <exception cref="ArgumentException"><paramref name="match"/> 为空数组。</exception> /// <exception cref="ArgumentException"><paramref name="match"/> 中包含为 <c>null</c> 的元素。</exception> /// <exception cref="AmbiguousMatchException"><paramref name="match"/> 包含多个与 <paramref name="value"/> /// 匹配程度相同的字段。</exception> /// <exception cref="MissingFieldException"><paramref name="bindingAttr"/> 包含 /// <see cref="BindingFlags.SetField"/>,且 <paramref name="match"/> 不包含任何可接受 <paramref name="value"/> /// 的字段。</exception> public override FieldInfo BindToField(BindingFlags bindingAttr, FieldInfo[] match, [CanBeNull] object value, CultureInfo culture) { CommonExceptions.CheckCollectionItemNull(match, "match"); Contract.EndContractBlock(); int length = 0; if (bindingAttr.HasFlag(BindingFlags.SetField)) { // 在设置 SetField 标志时,根据 value 的类型进行选择。 Type valueType = value == null ? null : value.GetType(); for (int i = 0; i < match.Length; i++) { if (CanChangeType(valueType, match[i].FieldType)) { match[length++] = match[i]; } } if (length == 0) { throw CommonExceptions.MissingField(); } if (length > 1 && valueType != null) { // 多个可匹配字段,尝试寻找类型最匹配的字段。 length = FilterMember(match, length, (firstField, secondField) => CompareType(firstField.FieldType, secondField.FieldType, valueType)); } } else { length = match.Length; } FieldInfo best = GetDeepestMember(match, length); if (best == null) { throw CommonExceptions.AmbiguousMatchField(); } return(best); }
/// <summary> /// 基于提供的参数,从给定的方法集中选择要调用的方法。 /// </summary> /// <param name="bindingAttr"><see cref="BindingFlags"/> 值的按位组合。</param> /// <param name="match">用于匹配的候选方法集。</param> /// <param name="args">传入的参数。</param> /// <param name="modifiers">使绑定能够处理在其中修改了类型的参数签名的参数修饰符数组。</param> /// <param name="culture">一个 <see cref="CultureInfo"/> 实例, /// 用于在强制类型的联编程序实现中控制数据类型强制。</param> /// <param name="names">参数名(如果匹配时要考虑参数名)或 <c>null</c>(如果要将变量视为纯位置)。</param> /// <param name="state">方法返回之后,<paramref name="state"/> 包含一个联编程序提供的对象, /// 用于跟踪参数的重新排序。</param> /// <returns>匹配的方法。</returns> /// <exception cref="ArgumentNullException"><paramref name="match"/> 为 <c>null</c>。</exception> /// <exception cref="ArgumentNullException"><paramref name="args"/> 为 <c>null</c>。</exception> /// <exception cref="ArgumentException"><paramref name="match"/> 为空数组。</exception> /// <exception cref="ArgumentException"><paramref name="match"/> 中包含为 <c>null</c> 的元素。</exception> /// <exception cref="AmbiguousMatchException"><paramref name="match"/> 包含多个与 <paramref name="args"/> /// 匹配程度相同的方法。</exception> /// <exception cref="MissingFieldException"><paramref name="bindingAttr"/> 包含 /// <see cref="BindingFlags.SetField"/>,且 <paramref name="match"/> 不包含任何可接受 <paramref name="args"/> /// 的方法。</exception> public override MethodBase BindToMethod(BindingFlags bindingAttr, MethodBase[] match, ref object[] args, ParameterModifier[] modifiers, CultureInfo culture, string[] names, out object state) { CommonExceptions.CheckCollectionItemNull(match, "match"); CommonExceptions.CheckArgumentNull(args, "args"); if (names != null && names.Length > args.Length) { throw CommonExceptions.NamedParamTooBig("names"); } Contract.EndContractBlock(); // 检查参数名称数组,不能出现名称相同的参数。 if (names != null && !names.IsDistinct(StringComparer.Ordinal)) { throw CommonExceptions.DuplicateName("names"); } MethodArgumentsOption options = MethodArgumentsOption.None; if (isExplicit) { options |= MethodArgumentsOption.Explicit; } if (bindingAttr.HasFlag(BindingFlags.OptionalParamBinding)) { options |= MethodArgumentsOption.OptionalParamBinding; } int typesLen = args.Length; Type[] types = new Type[typesLen]; for (int i = 0; i < typesLen; i++) { object arg = args[i]; types[i] = arg == null ? null : arg.GetType(); } MethodMatchInfo[] infos = new MethodMatchInfo[match.Length]; MethodMatchInfo info; int length = 0; for (int i = 0; i < match.Length; i++) { int[] paramOrder = null; if (names != null) { paramOrder = CreateParamOrder(match[i], names, typesLen); if (paramOrder == null) { continue; } } info = MethodMatchInfo.GetMatchInfo(match[i], types, paramOrder, options); if (info != null) { infos[length++] = info; } } if (length == 0) { // 没有可匹配的方法。 state = null; throw CommonExceptions.MissingMethod(); } info = SelectMethod(infos, length, types); if (info == null) { state = null; throw CommonExceptions.AmbiguousMatchMethod(); } UpdateArgs(info, ref args, out state); return(info.Method); }