CustomReflectionContext 類別

定義

public ref class CustomReflectionContext abstract : System::Reflection::ReflectionContext

public abstract class CustomReflectionContext : System.Reflection.ReflectionContext

type CustomReflectionContext = class
    inherit ReflectionContext

Public MustInherit Class CustomReflectionContext
Inherits ReflectionContext

繼承

Object

ReflectionContext

CustomReflectionContext

衍生

System.ComponentModel.Composition.Registration.RegistrationBuilder

範例

以下範例示範如何子類 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>) 方法。 這些方法會取得被反射物件及其當前反射上下文下的屬性清單，並回傳它在自訂反射上下文下應有的屬性清單。

若要為反射型別新增屬性，請覆寫該 AddProperties 方法。 該方法接受一個指定反射型別的參數，並回傳一串額外的屬性。 你應該用這個 CreateProperty 方法來建立並回傳屬性物件。 你可以在建立作為屬性 accessr 的屬性時指定代理，也可以省略其中一個 access，以建立只讀或只寫屬性。 請注意，這類虛擬屬性沒有元資料或通用中介語言（CIL）支持。