/// <summary>
/// 使用针对绑定失败的指定行为，创建用于表示获取或设置指定静态或实例字段的指定类型的委托。
/// </summary>
/// <param name="field">描述委托要表示的静态或实例字段的 <see cref="FieldInfo"/>。</param>
/// <param name="delegateType">要创建的委托的类型。</param>
/// <returns>指定类型的委托，表示获取或设置指定的静态或实例字段。</returns>
/// <remarks>如果是实例字段，需要将实例对象作为委托的第一个参数。
/// 如果委托具有返回值，则认为是获取字段，否则认为是设置字段。
/// 支持参数的强制类型转换，参数声明可以与实际类型不同。</remarks>
/// <exception cref="ArgumentNullException"><paramref name="field"/> 为 <c>null</c>。</exception>
/// <exception cref="ArgumentNullException"><paramref name="delegateType"/> 为 <c>null</c>。</exception>
/// <exception cref="ArgumentException"><paramref name="delegateType"/> 不是委托类型。</exception>
/// <exception cref="ArgumentException">无法绑定 <paramref name="field"/>。</exception>
/// <exception cref="MethodAccessException">调用方无权访问 <paramref name="field"/>。</exception>
public static Delegate CreateDelegate(this FieldInfo field, Type delegateType)
{
CommonExceptions.CheckArgumentNull(field, "field");
CommonExceptions.CheckArgumentNull(delegateType, "delegateType");
Contract.Ensures(Contract.Result <Delegate>() != null);
CommonExceptions.CheckDelegateType(delegateType, "delegateType");
CommonExceptions.CheckUnboundGenParam(field, "field");
Delegate dlg = CreateOpenDelegate(field, delegateType);
if (dlg == null)
{
throw CommonExceptions.BindTargetField("field");
}
return(dlg);
}
/// <summary>
/// 使用针对绑定失败的指定行为，创建用于表示获取或设置指定静态或实例字段的指定类型的委托。
/// </summary>
/// <param name="field">描述委托要表示的静态或实例字段的 <see cref="FieldInfo"/>。</param>
/// <param name="delegateType">要创建的委托的类型。</param>
/// <param name="throwOnBindFailure">为 <c>true</c>，表示无法绑定 <paramref name="field"/>
/// 时引发异常；否则为 <c>false</c>。</param>
/// <returns>指定类型的委托，表示获取或设置指定的静态或实例字段。</returns>
/// <remarks>如果是实例字段，需要将实例对象作为委托的第一个参数。
/// 如果委托具有返回值，则认为是获取字段，否则认为是设置字段。
/// 支持参数的强制类型转换，参数声明可以与实际类型不同。</remarks>
/// <exception cref="ArgumentNullException"><paramref name="field"/> 为 <c>null</c>。</exception>
/// <exception cref="ArgumentNullException"><paramref name="delegateType"/> 为 <c>null</c>。</exception>
/// <exception cref="ArgumentException"><paramref name="delegateType"/> 不是委托类型。</exception>
/// <exception cref="ArgumentException">无法绑定 <paramref name="field"/>
/// 且 <paramref name="throwOnBindFailure"/> 为 <c>true</c>。</exception>
/// <exception cref="MethodAccessException">调用方无权访问 <paramref name="field"/>。</exception>
public static Delegate CreateDelegate(this FieldInfo field, Type delegateType, bool throwOnBindFailure)
{
CommonExceptions.CheckArgumentNull(field, "field");
CommonExceptions.CheckArgumentNull(delegateType, "delegateType");
Contract.EndContractBlock();
CommonExceptions.CheckDelegateType(delegateType, "delegateType");
CommonExceptions.CheckUnboundGenParam(field, "field");
Delegate dlg = CreateOpenDelegate(field, delegateType);
if (dlg == null && throwOnBindFailure)
{
throw CommonExceptions.BindTargetField("field");
}
return(dlg);
}
/// <summary>
/// 使用指定的第一个参数，创建用于表示获取或设置指定的静态或实例字段的指定类型的委托。
/// </summary>
/// <param name="field">描述委托要表示的静态或实例字段的 <see cref="FieldInfo"/>。</param>
/// <param name="delegateType">要创建的委托的类型。</param>
/// <param name="firstArgument">如果是实例字段，则作为委托要绑定到的对象；否则将作为字段的第一个参数。</param>
/// <returns>指定类型的委托，表示获取或设置指定的静态或实例字段。</returns>
/// <remarks>如果委托具有返回值，则认为是获取字段，否则认为是设置字段。
/// 支持参数的强制类型转换，参数声明可以与实际类型不同。</remarks>
/// <exception cref="ArgumentNullException"><paramref name="field"/> 为 <c>null</c>。</exception>
/// <exception cref="ArgumentNullException"><paramref name="delegateType"/> 为 <c>null</c>。</exception>
/// <exception cref="ArgumentException"><paramref name="delegateType"/> 不是委托类型。</exception>
/// <exception cref="ArgumentException">无法绑定 <paramref name="field"/>。</exception>
/// <exception cref="MethodAccessException">调用方无权访问 <paramref name="field"/>。</exception>
public static Delegate CreateDelegate(this FieldInfo field, Type delegateType, object firstArgument)
{
CommonExceptions.CheckArgumentNull(field, nameof(field));
CommonExceptions.CheckArgumentNull(delegateType, nameof(delegateType));
Contract.Ensures(Contract.Result <Delegate>() != null);
CommonExceptions.CheckDelegateType(delegateType, nameof(delegateType));
CommonExceptions.CheckUnboundGenParam(field, nameof(field));
var dlg = CreateClosedDelegate(field, delegateType, firstArgument);
if (dlg == null)
{
throw CommonExceptions.BindTargetField(nameof(field));
}
return(dlg);
}
/// <summary>
/// 使用指定的第一个参数和针对绑定失败的指定行为，创建用于表示获取或设置指定的静态或实例字段的指定类型的委托。
/// </summary>
/// <param name="field">描述委托要表示的静态或实例字段的 <see cref="FieldInfo"/>。</param>
/// <param name="delegateType">要创建的委托的类型。</param>
/// <param name="firstArgument">如果是实例字段，则作为委托要绑定到的对象；否则将作为字段的第一个参数。</param>
/// <param name="throwOnBindFailure">为 <c>true</c>，表示无法绑定 <paramref name="field"/>
/// 时引发异常；否则为 <c>false</c>。</param>
/// <returns>指定类型的委托，表示获取或设置指定的静态或实例字段。</returns>
/// <remarks>如果委托具有返回值，则认为是获取字段，否则认为是设置字段。
/// 支持参数的强制类型转换，参数声明可以与实际类型不同。</remarks>
/// <exception cref="ArgumentNullException"><paramref name="field"/> 为 <c>null</c>。</exception>
/// <exception cref="ArgumentNullException"><paramref name="delegateType"/> 为 <c>null</c>。</exception>
/// <exception cref="ArgumentException"><paramref name="delegateType"/> 不是委托类型。</exception>
/// <exception cref="ArgumentException">无法绑定 <paramref name="field"/>
/// 且 <paramref name="throwOnBindFailure"/> 为 <c>true</c>。</exception>
/// <exception cref="MethodAccessException">调用方无权访问 <paramref name="field"/>。</exception>
public static Delegate CreateDelegate(this FieldInfo field, Type delegateType, object firstArgument,
bool throwOnBindFailure)
{
CommonExceptions.CheckArgumentNull(field, nameof(field));
CommonExceptions.CheckArgumentNull(delegateType, nameof(delegateType));
Contract.EndContractBlock();
CommonExceptions.CheckDelegateType(delegateType, nameof(delegateType));
CommonExceptions.CheckUnboundGenParam(field, nameof(field));
var dlg = CreateClosedDelegate(field, delegateType, firstArgument);
if (dlg == null && throwOnBindFailure)
{
throw CommonExceptions.BindTargetField(nameof(field));
}
return(dlg);
}
/// <summary>
/// 使用针对绑定失败的指定行为，创建用于表示获取或设置指定静态或实例字段的指定类型的委托。
/// </summary>
/// <typeparam name="TDelegate">要创建的委托的类型。</typeparam>
/// <param name="field">描述委托要表示的静态或实例字段的 <see cref="FieldInfo"/>。</param>
/// <param name="throwOnBindFailure">为 <c>true</c>，表示无法绑定 <paramref name="field"/>
/// 时引发异常；否则为 <c>false</c>。</param>
/// <returns>指定类型的委托，表示获取或设置指定的静态或实例字段。</returns>
/// <remarks>如果是实例字段，需要将实例对象作为委托的第一个参数。
/// 如果委托具有返回值，则认为是获取字段，否则认为是设置字段。
/// 支持参数的强制类型转换，参数声明可以与实际类型不同。</remarks>
/// <exception cref="ArgumentNullException"><paramref name="field"/> 为 <c>null</c>。</exception>
/// <exception cref="ArgumentException"><typeparamref name="TDelegate"/> 不是委托类型。</exception>
/// <exception cref="ArgumentException">无法绑定 <paramref name="field"/>
/// 且 <paramref name="throwOnBindFailure"/> 为 <c>true</c>。</exception>
/// <exception cref="MethodAccessException">调用方无权访问 <paramref name="field"/>。</exception>
public static TDelegate CreateDelegate <TDelegate>(this FieldInfo field, bool throwOnBindFailure)
where TDelegate : class
{
CommonExceptions.CheckArgumentNull(field, "field");
Contract.EndContractBlock();
Type type = typeof(TDelegate);
CommonExceptions.CheckDelegateType(type);
CommonExceptions.CheckUnboundGenParam(field, "field");
Delegate dlg = CreateOpenDelegate(field, type);
if (dlg == null && throwOnBindFailure)
{
throw CommonExceptions.BindTargetField("field");
}
return(dlg as TDelegate);
}
/// <summary>
/// 使用指定的第一个参数，创建用于表示获取或设置指定的静态或实例字段的指定类型的委托。
/// </summary>
/// <typeparam name="TDelegate">要创建的委托的类型。</typeparam>
/// <param name="field">描述委托要表示的静态或实例字段的 <see cref="FieldInfo"/>。</param>
/// <param name="firstArgument">如果是实例字段，则作为委托要绑定到的对象；否则将作为字段的第一个参数。</param>
/// <returns>指定类型的委托，表示获取或设置指定的静态或实例字段。</returns>
/// <remarks>如果委托具有返回值，则认为是获取字段，否则认为是设置字段。
/// 支持参数的强制类型转换，参数声明可以与实际类型不同。</remarks>
/// <exception cref="ArgumentNullException"><paramref name="field"/> 为 <c>null</c>。</exception>
/// <exception cref="ArgumentException"><typeparamref name="TDelegate"/> 不是委托类型。</exception>
/// <exception cref="ArgumentException">无法绑定 <paramref name="field"/>。</exception>
/// <exception cref="MethodAccessException">调用方无权访问 <paramref name="field"/>。</exception>
public static TDelegate CreateDelegate <TDelegate>(this FieldInfo field, object firstArgument)
where TDelegate : class
{
CommonExceptions.CheckArgumentNull(field, "field");
Contract.Ensures(Contract.Result <TDelegate>() != null);
Type type = typeof(TDelegate);
CommonExceptions.CheckDelegateType(type);
CommonExceptions.CheckUnboundGenParam(field, "field");
Delegate dlg = CreateClosedDelegate(field, type, firstArgument);
if (dlg == null)
{
throw CommonExceptions.BindTargetField("field");
}
return(dlg as TDelegate);
}
/// <summary>
/// 创建用于表示获取或设置指定静态或实例字段的指定类型的委托。
/// </summary>
/// <typeparam name="TDelegate">要创建的委托的类型。</typeparam>
/// <param name="field">描述委托要表示的静态或实例字段的 <see cref="FieldInfo"/>。</param>
/// <returns>指定类型的委托，表示获取或设置指定的静态或实例字段。</returns>
/// <remarks>如果是实例字段，需要将实例对象作为委托的第一个参数。
/// 如果委托具有返回值，则认为是获取字段，否则认为是设置字段。
/// 支持参数的强制类型转换，参数声明可以与实际类型不同。</remarks>
/// <exception cref="ArgumentNullException"><paramref name="field"/> 为 <c>null</c>。</exception>
/// <exception cref="ArgumentException"><typeparamref name="TDelegate"/> 不是委托类型。</exception>
/// <exception cref="ArgumentException">无法绑定 <paramref name="field"/> 。</exception>
/// <exception cref="MethodAccessException">调用方无权访问 <paramref name="field"/>。</exception>
public static TDelegate CreateDelegate <TDelegate>(this FieldInfo field)
where TDelegate : class
{
CommonExceptions.CheckArgumentNull(field, nameof(field));
Contract.Ensures(Contract.Result <TDelegate>() != null);
var type = typeof(TDelegate);
CommonExceptions.CheckDelegateType(type);
CommonExceptions.CheckUnboundGenParam(field, nameof(field));
var dlg = CreateOpenDelegate(field, type);
if (dlg == null)
{
throw CommonExceptions.BindTargetField(nameof(field));
}
return(dlg as TDelegate);
}
/// <summary>
/// 使用指定的第一个参数和针对绑定失败的指定行为，创建用于表示获取或设置指定的静态或实例字段的指定类型的委托。
/// </summary>
/// <typeparam name="TDelegate">要创建的委托的类型。</typeparam>
/// <param name="field">描述委托要表示的静态或实例字段的 <see cref="FieldInfo"/>。</param>
/// <param name="firstArgument">如果是实例字段，则作为委托要绑定到的对象；否则将作为字段的第一个参数。</param>
/// <param name="throwOnBindFailure">为 <c>true</c>，表示无法绑定 <paramref name="field"/>
/// 时引发异常；否则为 <c>false</c>。</param>
/// <returns>指定类型的委托，表示获取或设置指定的静态或实例字段。</returns>
/// <remarks>如果委托具有返回值，则认为是获取字段，否则认为是设置字段。
/// 支持参数的强制类型转换，参数声明可以与实际类型不同。</remarks>
/// <exception cref="ArgumentNullException"><paramref name="field"/> 为 <c>null</c>。</exception>
/// <exception cref="ArgumentException"><typeparamref name="TDelegate"/> 不是委托类型。</exception>
/// <exception cref="ArgumentException">无法绑定 <paramref name="field"/>
/// 且 <paramref name="throwOnBindFailure"/> 为 <c>true</c>。</exception>
/// <exception cref="MethodAccessException">调用方无权访问 <paramref name="field"/>。</exception>
public static TDelegate CreateDelegate <TDelegate>(this FieldInfo field, object firstArgument,
bool throwOnBindFailure)
where TDelegate : class
{
CommonExceptions.CheckArgumentNull(field, nameof(field));
Contract.EndContractBlock();
var type = typeof(TDelegate);
CommonExceptions.CheckDelegateType(type);
CommonExceptions.CheckUnboundGenParam(field, nameof(field));
var dlg = CreateClosedDelegate(field, type, firstArgument);
if (dlg == null && throwOnBindFailure)
{
throw CommonExceptions.BindTargetField(nameof(field));
}
return(dlg as TDelegate);
}
