CustomReflectionContext 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示可自定义的反射上下文。
public ref class CustomReflectionContext abstract : System::Reflection::ReflectionContextpublic abstract class CustomReflectionContext : System.Reflection.ReflectionContexttype CustomReflectionContext = class
inherit ReflectionContextPublic MustInherit Class CustomReflectionContext
Inherits ReflectionContext- 继承
- 派生
示例
以下示例演示如何将自定义属性 CustomReflectionContext 子类添加到名称以“To”开头的给定类型的所有成员。 若要运行此代码，请将其粘贴到空控制台项目中，并确保包含对 System.Reflection.Context.dll的引用。
//A blank example attribute.
class myAttribute : Attribute
{
}
//Reflection context with custom rules.
class myCRC : CustomReflectionContext
{
//Called whenever the reflection context checks for custom attributes.
protected override IEnumerable<object> GetCustomAttributes(MemberInfo member, IEnumerable<object> declaredAttributes)
{
//Add example attribute to "To*" members.
if (member.Name.StartsWith("To")) {
yield return new myAttribute();
}
//Keep existing attributes as well.
foreach (var attr in declaredAttributes) yield return attr;
}
}
class Program
{
static void Main(string[] args)
{
myCRC mc = new myCRC();
Type t = typeof(String);
//A representation of the type in the default reflection context.
TypeInfo ti = t.GetTypeInfo();
//A representation of the type in the customized reflection context.
TypeInfo myTI = mc.MapType(ti);
//Display all the members of the type and their attributes.
foreach (MemberInfo m in myTI.DeclaredMembers)
{
Console.WriteLine(m.Name + ":");
foreach (Attribute cd in m.GetCustomAttributes())
{
Console.WriteLine(cd.GetType());
}
}
Console.WriteLine();
//The "ToString" member as represented in the default reflection context.
MemberInfo mi1 = ti.GetDeclaredMethods("ToString").FirstOrDefault();
//All the attributes of "ToString" in the default reflection context.
Console.WriteLine("'ToString' Attributes in Default Reflection Context:");
foreach (Attribute cd in mi1.GetCustomAttributes())
{
Console.WriteLine(cd.GetType());
}
Console.WriteLine();
//The same member in the custom reflection context.
mi1 = myTI.GetDeclaredMethods("ToString").FirstOrDefault();
//All its attributes, for comparison. myAttribute is now included.
Console.WriteLine("'ToString' Attributes in Custom Reflection Context:");
foreach (Attribute cd in mi1.GetCustomAttributes())
{
Console.WriteLine(cd.GetType());
}
Console.ReadLine();
}
}
注解
CustomReflectionContext 提供了一种从反射对象添加或删除自定义属性的方法，或者向这些对象添加虚拟属性，而无需重新实现完整的反射模型。 默认 CustomReflectionContext 只需包装反射对象而不进行任何更改，但通过子类化和重写相关方法，可以添加、删除或更改应用于任何反射参数或成员的属性，或向反射类型添加新属性。
例如，假设代码遵循将特定属性应用于工厂方法的约定，但现在需要使用缺少属性的第三方代码。 可以使用 CustomReflectionContext 指定规则来标识应具有属性的对象，并在从代码中查看这些属性时向这些对象提供这些属性。
若要有效使用 CustomReflectionContext，使用反射对象的代码必须支持指定反射上下文的概念，而不是假定所有反射对象都与运行时反射上下文相关联。 .NET Framework 中的许多反射方法为此提供了 ReflectionContext 参数。
若要修改应用于反射参数或成员的属性，请重写 GetCustomAttributes(ParameterInfo, IEnumerable<Object>) 或 GetCustomAttributes(MemberInfo, IEnumerable<Object>) 方法。 这些方法采用反射对象及其当前反射上下文下的属性列表，并返回它在自定义反射上下文下应具有的属性列表。
警告
CustomReflectionContext 方法不应通过对提供的 MemberInfo 或 ParameterInfo 实例调用 GetCustomAttributes 方法直接访问反射对象或方法的属性列表，而是应改用作为参数传递给 GetCustomAttributes 方法重载的 declaredAttributes 列表。
若要将属性添加到反射类型，请重写 AddProperties 方法。 该方法接受指定反射类型的参数，并返回其他属性的列表。 应使用 CreateProperty 方法创建要返回的属性对象。 可以在创建将用作属性访问器的属性时指定委托，并且可以省略其中一个访问器来创建只读或只读属性。 请注意，此类虚拟属性没有元数据或公共中间语言（CIL）支持。
警告
处理反射上下文时，请谨慎处理反射对象之间的相等性，因为对象可能在多个上下文中表示相同的反射对象。 可以使用 MapType 方法获取反射对象的特定反射上下文版本。
警告
CustomReflectionContext 对象更改特定反射对象返回的属性，例如 GetCustomAttributes 方法获取的属性。 它不会更改 GetCustomAttributesData 方法返回的自定义属性数据，这两个列表在使用自定义反射上下文时不匹配。
构造函数
| CustomReflectionContext() |
初始化 CustomReflectionContext 类的新实例。 |
| CustomReflectionContext(ReflectionContext) |
使用指定的反射上下文作为基初始化 CustomReflectionContext 类的新实例。 |
方法
| AddProperties(Type) |
在派生类中重写时，提供指定类型的附加属性集合，如此反射上下文中所示。 |
| CreateProperty(Type, String, Func<Object,Object>, Action<Object,Object>, IEnumerable<Attribute>, IEnumerable<Attribute>, IEnumerable<Attribute>) |
创建一个对象，该对象表示要添加到类型的属性、与 AddProperties(Type) 方法一起使用以及使用指定的自定义属性。 |
| CreateProperty(Type, String, Func<Object,Object>, Action<Object,Object>) |
创建一个对象，该对象表示要添加到类型的属性，以用于 AddProperties(Type) 方法。 |
| Equals(Object) |
确定指定的对象是否等于当前对象。 (继承自 Object) |
| GetCustomAttributes(MemberInfo, IEnumerable<Object>) |
在派生类中重写时，提供指定成员的自定义属性列表，如此反射上下文中所示。 |
| GetCustomAttributes(ParameterInfo, IEnumerable<Object>) |
在派生类中重写时，提供指定参数的自定义属性列表，如此反射上下文中所示。 |
| GetHashCode() |
用作默认哈希函数。 (继承自 Object) |
| GetType() |
获取当前实例的 Type。 (继承自 Object) |
| GetTypeForObject(Object) |
获取此反射上下文中指定对象的类型的表示形式。 (继承自 ReflectionContext) |
| MapAssembly(Assembly) |
在此反射上下文中，获取由另一反射上下文中的对象表示的程序集的表示形式。 |
| MapType(TypeInfo) |
在此反射上下文中，获取由另一反射上下文中的对象表示的类型表示的表示形式。 |
| MemberwiseClone() |
创建当前 Object的浅表副本。 (继承自 Object) |
| ToString() |
返回一个表示当前对象的字符串。 (继承自 Object) |
