CustomReflectionContext クラス

定義

名前空間:

System.Reflection.Context

アセンブリ:

System.Reflection.Context.dll

パッケージ:

System.Reflection.Context v9.0.0-rc.1.24431.7

ソース:

CustomReflectionContext.cs

カスタマイズ可能なリフレクション コンテキストを表します。

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

例

次の例では、名前が "To" で始まる特定の型のすべてのメンバーにカスタム属性を追加する方法を示 CustomReflectionContext します。 このコードを実行するには、空のコンソール プロジェクトに貼り付け、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(MemberInfo, IEnumerable<Object>) メソッドをGetCustomAttributes(ParameterInfo, IEnumerable<Object>)オーバーライドします。 これらのメソッドは、現在のリフレクション コンテキストの下にあるリフレクション オブジェクトと属性のリストを受け取り、カスタム リフレクション コンテキストの下で持つ必要がある属性の一覧を返します。

警告

CustomReflectionContextメソッドは、指定ParameterInfoMemberInfoされた インスタンスまたは インスタンスで メソッドを呼び出GetCustomAttributesすことによって、反映されたオブジェクトまたはメソッドの属性の一覧に直接アクセスしないようにする必要がありますが、代わりに list をdeclaredAttributes使用する必要があります。このリストは、メソッドのオーバーロードにGetCustomAttributesパラメーターとして渡されます。

反映された型にプロパティを追加するには、 メソッドをオーバーライドします AddProperties 。 メソッドは、反映された型を指定するパラメーターを受け取り、追加のプロパティの一覧を返します。 メソッドを使用して、 CreateProperty 返すプロパティ オブジェクトを作成する必要があります。 プロパティ アクセサーとして機能するプロパティを作成するときにデリゲートを指定できます。また、いずれかのアクセサーを省略して、読み取り専用または書き込み専用のプロパティを作成できます。 このようなダミー プロパティには、メタデータや共通中間言語 (CIL) のバッキングがないことに注意してください。

警告

リフレクション コンテキストを使用する場合は、オブジェクトが複数のコンテキストで同じ反射オブジェクトを表す可能性があるため、リフレクション オブジェクト間の等価性に注意してください。 メソッドを MapType 使用して、特定のリフレクション コンテキストのリフレクション オブジェクトのバージョンを取得できます。

警告

オブジェクトは CustomReflectionContext 、 メソッドによって取得されたものなど、特定のリフレクション オブジェクトによって返される属性を GetCustomAttributes 変更します。 メソッドによって GetCustomAttributesData 返されるカスタム属性データは変更されず、カスタム リフレクション コンテキストを使用する場合、これら 2 つのリストは一致しません。

コンストラクター

CustomReflectionContext()	CustomReflectionContext クラスの新しいインスタンスを初期化します。
CustomReflectionContext(ReflectionContext)	指定したリフレクション コンテキストを使用して、CustomReflectionContext クラスの新しいインスタンスをベースとして初期化します。

メソッド

AddProperties(Type)	派生クラスでオーバーライドされると、このリフレクション コンテキストで表されるように、指定された型の追加のプロパティのコレクションを提供します。
CreateProperty(Type, String, Func<Object,Object>, Action<Object,Object>)	AddProperties(Type) メソッドで使用される、型に追加するプロパティを表すオブジェクトを作成します。
CreateProperty(Type, String, Func<Object,Object>, Action<Object,Object>, IEnumerable<Attribute>, IEnumerable<Attribute>, IEnumerable<Attribute>)	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)