Type.GetProperty メソッド

定義

現在の Type の特定のプロパティを取得します。

オーバーロード

GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])

指定したバインディング制約を使用して、指定した引数の型および修飾子と一致するパラメーターが設定された指定のプロパティを検索します。

GetProperty(String)

指定した名前のパブリック プロパティを検索します。

GetProperty(String, BindingFlags)

指定されたバインディング制約を使用して、指定されたプロパティを検索します。

GetProperty(String, Type)

指定した名前および戻り値の型を持つパブリック プロパティを検索します。

GetProperty(String, Type[])

指定したパブリック プロパティのうち、指定した引数型と一致するパラメーターが設定されているものを検索します。

GetProperty(String, Type, Type[])

指定したパブリック プロパティのうち、指定した引数型と一致するパラメーターが設定されているものを検索します。

GetProperty(String, Type, Type[], ParameterModifier[])

指定したパブリック プロパティのうち、指定した引数の型および修飾子と一致するパラメーターが設定されているものを検索します。

GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])

指定したバインディング制約を使用して、指定した引数の型および修飾子と一致するパラメーターが設定された指定のプロパティを検索します。

public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, Type ^ returnType, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public System.Reflection.PropertyInfo? GetProperty (string name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, Type? returnType, Type[] types, System.Reflection.ParameterModifier[]? modifiers);
public System.Reflection.PropertyInfo GetProperty (string name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, Type returnType, Type[] types, System.Reflection.ParameterModifier[] modifiers);
abstract member GetProperty : string * System.Reflection.BindingFlags * System.Reflection.Binder * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo
override this.GetProperty : string * System.Reflection.BindingFlags * System.Reflection.Binder * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, bindingAttr As BindingFlags, binder As Binder, returnType As Type, types As Type(), modifiers As ParameterModifier()) As PropertyInfo

パラメーター

name
String

取得するプロパティの名前を格納している文字列。

bindingAttr
BindingFlags

検索を実施する方法を指定する列挙値のビットごとの組み合わせ。

または null を返す場合は Default

binder
Binder

一連のプロパティを定義し、バインディングを有効にするオブジェクト。バインディングには、オーバーロードされたメソッドの選択、引数の型の強制変換、リフレクションによるメンバーの呼び出しなどが含まれます。

または Nothing を使用する場合は、null 参照 (Visual Basic の場合は DefaultBinder)。

returnType
Type

プロパティの戻り値の型。

types
Type[]

取得するインデックス付きプロパティに対するパラメーターの数値、順序、および型を表す Type オブジェクトの配列。

または インデックス付けされていないプロパティを取得するための、Type 型の空の配列 (Type[] types = new Type[0])。

modifiers
ParameterModifier[]

types 配列内の対応する要素に関連付けられている属性を表す ParameterModifier オブジェクトの配列。 既定のバインダーでは、このパラメーターは処理されません。

戻り値

PropertyInfo

指定した要件と一致するプロパティが存在する場合は、そのプロパティを表すオブジェクト。それ以外の場合は null

実装

例外

指定された名前を持ち、指定されたバインディング制約に一致する 1 つ以上のプロパティが存在します。

namenullです。

または typesnullです。

types が多次元です。

または modifiers が多次元です。

または typesmodifiers の長さが同じではありません。

types の要素は null です。

注釈

パブリックであるアクセサーが少なくとも1つある場合、プロパティはリフレクションに対してパブリックと見なされます。 それ以外の場合、プロパティはプライベートと見なされ、 BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual Basic では、を使用して値を結合 Or ) を使用して取得する必要があります。

既定のバインダーでは (パラメーター) は処理されませんが ParameterModifier modifiers 、抽象クラスを使用し System.Reflection.Binder て、処理を実行するカスタムバインダーを書き込むことができ modifiers ます。 ParameterModifier は COM 相互運用機能を使用してを呼び出す場合にのみ使用され、参照によって渡されるパラメーターのみが処理されます。

次の表は、型に対してリフレクションを行うときに、メソッドによって返される基底クラスのメンバーを示してい Get ます。

メンバーの型 静的 非静的
コンストラクター いいえ いいえ
フィールド いいえ はい。 フィールドは、常に名前と署名で隠ぺいされます。
Event 適用なし 共通型システムの規則は、継承が、プロパティを実装するメソッドと同じであることを示します。 リフレクションは、プロパティを名前で隠す、署名として扱います。 下記のメモ2を参照してください。
メソッド いいえ はい。 メソッド (仮想と非仮想の両方) は、非表示にするか、名前と署名を隠すことができます。
入れ子にされた型 いいえ いいえ
プロパティ 適用なし 共通型システムの規則は、継承が、プロパティを実装するメソッドと同じであることを示します。 リフレクションは、プロパティを名前で隠す、署名として扱います。 下記のメモ2を参照してください。
  1. 名前による隠ぺいと署名では、カスタム修飾子、戻り値の型、パラメーターの型、sentinel、アンマネージ呼び出し規約を含む、シグネチャのすべての部分が考慮されます。 これは、バイナリ比較です。

  2. リフレクションの場合、プロパティとイベントは、名前とシグネチャが隠ぺいされます。 基底クラスに get と set の両方のアクセサーを持つプロパティがあり、派生クラスに get アクセサーのみがある場合、派生クラスのプロパティは基底クラスのプロパティを非表示にします。基底クラスの setter にアクセスすることはできません。

  3. カスタム属性は、共通型システムの一部ではありません。

次の BindingFlags フィルターフラグを使用して、検索に含めるプロパティを定義できます。

  • BindingFlags.Instance戻り値を取得するには、またはを指定する必要があり BindingFlags.Static ます。

  • BindingFlags.Public検索にパブリックプロパティを含めるには、を指定します。

  • BindingFlags.NonPublic検索にパブリックでないプロパティ (プライベート、内部、および保護されたプロパティ) を含めるように指定します。

  • BindingFlags.FlattenHierarchy階層の上位にとの静的メンバーを含めるように指定します。 public protected 継承された private クラスの静的メンバーは含まれません。

次の BindingFlags 修飾子フラグを使用して、検索の動作を変更できます。

  • BindingFlags.IgnoreCase の大文字と小文字を区別しない場合は name

  • BindingFlags.DeclaredOnly で宣言されたプロパティだけを検索する Type 場合は。単純に継承されたプロパティではありません。

詳細については、「System.Reflection.BindingFlags」を参照してください。

現在のが Type 構築ジェネリック型を表している場合、このメソッドは、 PropertyInfo 適切な型引数によって置き換えられた型パラメーターを持つを返します。

現在のが Type ジェネリック型またはジェネリックメソッドの定義の型パラメーターを表している場合、このメソッドはクラスの制約のプロパティを検索します。

インデクサーと既定のプロパティ

Visual Basic 2005、Visual C# 2005、および Visual C++ 2005 には、インデックス付きプロパティにアクセスするための構文が簡略化されており、1つのインデックス付きプロパティをその型の既定値にすることができます。 たとえば、変数がを参照している場合、 myList ArrayList 構文 myList[3] ( myList(3) Visual Basic) は、インデックスが3の要素を取得します。 プロパティをオーバーロードすることができます。

C# では、この機能はインデクサーと呼ばれ、名前で参照することはできません。 既定では、C# インデクサーは "Item" という名前のインデックス付きプロパティとしてメタデータに表示されます。 ただし、クラスライブラリの開発者は属性を使用して、 IndexerNameAttribute メタデータ内のインデクサーの名前を変更できます。 たとえば、クラスに String はという名前のインデクサーがあり Chars[] ます。 C# 以外の言語を使用して作成されたインデックス付きプロパティには、Item 以外の名前を付けることもできます。

型に既定のプロパティがあるかどうかを判断するには、メソッドを使用して GetCustomAttributes(Type, Boolean) 属性をテストし DefaultMemberAttribute ます。 型にが含まれている場合 DefaultMemberAttributeMemberName プロパティは既定のプロパティの名前を返します。

こちらもご覧ください

適用対象

GetProperty(String)

指定した名前のパブリック プロパティを検索します。

public:
 System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name);
public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name);
public System.Reflection.PropertyInfo? GetProperty (string name);
public System.Reflection.PropertyInfo GetProperty (string name);
member this.GetProperty : string -> System.Reflection.PropertyInfo
abstract member GetProperty : string -> System.Reflection.PropertyInfo
override this.GetProperty : string -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String) As PropertyInfo

パラメーター

name
String

取得するパブリック プロパティの名前を格納している文字列。

戻り値

PropertyInfo

指定した名前のパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は null

実装

例外

指定した名前のプロパティが複数個見つかりました。

namenullです。

次の例では、ユーザー定義クラスの オブジェクトを取得し、そのクラスの プロパティを取得して、 Type プロパティ名を表示します。

using namespace System;
using namespace System::Reflection;
ref class MyClass
{
private:
   int myProperty;

public:

   property int MyProperty 
   {
      // Declare MyProperty.
      int get()
      {
         return myProperty;
      }

      void set( int value )
      {
         myProperty = value;
      }
   }
};

int main()
{
   try
   {
      // Get the Type object corresponding to MyClass.
      Type^ myType = MyClass::typeid;
      
      // Get the PropertyInfo object by passing the property name.
      PropertyInfo^ myPropInfo = myType->GetProperty( "MyProperty" );
      
      // Display the property name.
      Console::WriteLine( "The {0} property exists in MyClass.", myPropInfo->Name );
   }
   catch ( NullReferenceException^ e ) 
   {
      Console::WriteLine( "The property does not exist in MyClass. {0}", e->Message );
   }
}

using System;
using System.Reflection;

class MyClass
{
    private int myProperty;
    // Declare MyProperty.
    public int MyProperty
    {
        get
        {
            return myProperty;
        }
        set
        {
            myProperty=value;
        }
    }
}
public class MyTypeClass
{
    public static void Main(string[] args)
    {
        try
        {
            // Get the Type object corresponding to MyClass.
            Type myType=typeof(MyClass);
            // Get the PropertyInfo object by passing the property name.
            PropertyInfo myPropInfo = myType.GetProperty("MyProperty");
            // Display the property name.
            Console.WriteLine("The {0} property exists in MyClass.", myPropInfo.Name);
        }
        catch(NullReferenceException e)
        {
            Console.WriteLine("The property does not exist in MyClass." + e.Message);
        }
    }
}
Imports System.Reflection
Class MyClass1
    Private myProperty1 As Integer
    ' Declare MyProperty.

    Public Property MyProperty() As Integer
        Get
            Return myProperty1
        End Get
        Set(ByVal Value As Integer)
            myProperty1 = Value
        End Set
    End Property
End Class

Public Class MyTypeClass
    Public Shared Sub Main(ByVal args() As String)
        Try
            ' Get Type Object corresponding to MyClass.
            Dim myType As Type = GetType(MyClass1)
            ' Get PropertyInfo object by passing property name.
            Dim myPropInfo As PropertyInfo = myType.GetProperty("MyProperty")
            ' Display Name propety to console.
            Console.WriteLine("The {0} property exists in MyClass.", myPropInfo.Name)
        Catch e As NullReferenceException
            Console.WriteLine("The property does not exist in MyClass.", e.Message.ToString())
        End Try
    End Sub
End Class

内部的には、このプロパティはメタデータで "Item" という名前で参照されます。 リフレクションを使用しようとすると PropertyInfo 、 プロパティが正しく返されるように、この内部名を指定する必要 PropertyInfo があります。

注釈

の検索では name 、大文字と小文字が区別されます。 検索には、パブリック静的およびパブリック インスタンスのプロパティが含まれます。

プロパティには、public であるアクセサーが少なくとも 1 つある場合、リフレクションに対してパブリックと見なされます。 それ以外の場合、プロパティはプライベートと見なされ、|| (Visual Basic では、 を使用して値を組み合わせて BindingFlags.NonPublic BindingFlags.Instance 取得する BindingFlags.Static Or 必要があります。

現在の が構築されたジェネリック型を表す場合、このメソッドは、適切な型引数に置き換えられた型パラメーターを持つ Type PropertyInfo を返します。

現在の がジェネリック型またはジェネリック メソッドの定義で型パラメーターを表している場合、このメソッドはクラス制約の Type プロパティを検索します。

次のような状況 AmbiguousMatchException が発生します。

  • 型には、同じ名前を持ち、パラメーターの数が異なる 2 つのインデックス付きプロパティが含まれています。 あいまい性を解決するには、パラメーターの型を指定する GetProperty メソッドのオーバーロードを使用します。

  • 派生型は、同じ名前の継承されたプロパティを非表示にするプロパティを宣言します。このプロパティでは、 修飾子 new ( Shadows Visual Basic)。 あいまい性を解決するには、 メソッドオーバーロードを使用し、 フラグを追加して、継承されていないメンバーに検索 GetProperty(String, BindingFlags) BindingFlags.DeclaredOnly を制限します。

インデクサーと既定のプロパティ

Visual Basic 2005、Visual C# 2005、および Visual C++ 2005 では、インデックス付きプロパティにアクセスするための構文が簡略化され、インデックス付きプロパティの 1 つをその型の既定値に設定できます。 たとえば、変数が を参照している場合、構文 ( では Visual Basic) は、インデックスが 3 の要素 myList ArrayList myList[3] myList(3) を取得します。 プロパティをオーバーロードできます。

C# では、この機能はインデクサーと呼ばれます。名前で参照することはできません。 既定では、C# インデクサーは、"Item" という名前のインデックス付きプロパティとしてメタデータに表示されます。 ただし、クラス ライブラリ開発者は 属性を使用して、メタデータ内のインデ IndexerNameAttribute クサーの名前を変更できます。 たとえば、 クラス String には という名前のインデクサーがあります Chars[] 。 C# 以外の言語を使用して作成されたインデックス付きプロパティには、Item 以外の名前を指定することもできます。

型に既定のプロパティが含されているかどうかを判断するには、 メソッドを使用して GetCustomAttributes(Type, Boolean) 属性をテスト DefaultMemberAttribute します。 型に がある場合 DefaultMemberAttribute 、プロパティ MemberName は既定のプロパティの名前を返します。

こちらもご覧ください

適用対象

GetProperty(String, BindingFlags)

指定されたバインディング制約を使用して、指定されたプロパティを検索します。

public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, System::Reflection::BindingFlags bindingAttr);
public System.Reflection.PropertyInfo? GetProperty (string name, System.Reflection.BindingFlags bindingAttr);
public System.Reflection.PropertyInfo GetProperty (string name, System.Reflection.BindingFlags bindingAttr);
abstract member GetProperty : string * System.Reflection.BindingFlags -> System.Reflection.PropertyInfo
override this.GetProperty : string * System.Reflection.BindingFlags -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, bindingAttr As BindingFlags) As PropertyInfo

パラメーター

name
String

取得するプロパティの名前を格納している文字列。

bindingAttr
BindingFlags

検索を実施する方法を指定する列挙値のビットごとの組み合わせ。

または null を返す場合は Default

戻り値

PropertyInfo

指定した要件と一致するプロパティが存在する場合は、そのプロパティを表すオブジェクト。それ以外の場合は null

実装

例外

指定された名前を持ち、指定されたバインディング制約に一致する 1 つ以上のプロパティが存在します。

namenullです。

次の例では、ユーザー定義クラスの型を取得し、そのクラスのプロパティを取得して、指定されたバインディング制約に従ってプロパティ名を表示します。

using namespace System;
using namespace System::Reflection;
ref class MyClass
{
private:
   int myProperty;

public:

   property int MyProperty 
   {
      // Declare MyProperty.
      int get()
      {
         return myProperty;
      }

      void set( int value )
      {
         myProperty = value;
      }
   }
};

int main()
{
   try
   {
      // Get Type object of MyClass.
      Type^ myType = MyClass::typeid;
      
      // Get the PropertyInfo by passing the property name and specifying the BindingFlags.
      PropertyInfo^ myPropInfo = myType->GetProperty( "MyProperty", static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance) );
      
      // Display Name propety to console.
      Console::WriteLine( "{0} is a property of MyClass.", myPropInfo->Name );
   }
   catch ( NullReferenceException^ e ) 
   {
      Console::WriteLine( "MyProperty does not exist in MyClass. {0}", e->Message );
   }
}

using System;
using System.Reflection;
class MyClass
{
    private int myProperty;
    // Declare MyProperty.
    public int MyProperty
    {
        get
        {
            return myProperty;
        }
        set
        {
            myProperty=value;
        }
    }
}
public class MyTypeClass
{
    public static void Main(string[] args)
    {
        try
        {
            // Get Type object of MyClass.
            Type myType=typeof(MyClass);
            // Get the PropertyInfo by passing the property name and specifying the BindingFlags.
            PropertyInfo myPropInfo = myType.GetProperty("MyProperty", BindingFlags.Public | BindingFlags.Instance);
            // Display Name propety to console.
            Console.WriteLine("{0} is a property of MyClass.", myPropInfo.Name);
        }
        catch(NullReferenceException e)
        {
            Console.WriteLine("MyProperty does not exist in MyClass." +e.Message);
        }
    }
}

Imports System.Reflection
Module Module1
    Public Class MyClass1
        Private myProperty1 As Integer
        ' Declare MyProperty.
        Public Property MyProperty() As Integer
            Get
                Return myProperty1
            End Get
            Set(ByVal Value As Integer)
                myProperty1 = Value
            End Set
        End Property
        Public Shared Sub Main()
            Try
                ' Get a Type object corresponding to MyClass.
                Dim myType As Type = GetType(MyClass1)
                ' Get a PropertyInfo object by passing property name and specifying BindingFlags.
                Dim myPropInfo As PropertyInfo = myType.GetProperty("MyProperty", BindingFlags.Public Or BindingFlags.Instance)
                ' Display the Name property.
                Console.WriteLine("{0} is a property of MyClass.", myPropInfo.Name)
            Catch e As NullReferenceException
                Console.WriteLine("MyProperty does not exist in MyClass.", e.Message.ToString())
            End Try
        End Sub
    End Class
End Module 'Module1

注釈

プロパティには、public であるアクセサーが少なくとも 1 つある場合、リフレクションに対してパブリックと見なされます。 それ以外の場合、プロパティはプライベートと見なされ、|| (Visual Basic では、 を使用して値を組み合わせて BindingFlags.NonPublic BindingFlags.Instance 取得する BindingFlags.Static Or 必要があります。

検索に BindingFlags 含めるプロパティを定義するには、次のフィルター フラグを使用できます。

  • 戻り値を取得 BindingFlags.Instance するには、 BindingFlags.Static または を指定する必要があります。

  • 検索 BindingFlags.Public にパブリック プロパティを含めるには、 を指定します。

  • 非パブリック プロパティ (つまり、プライベート、内部、および保護されたプロパティ) を検索に含 BindingFlags.NonPublic める場合に指定します。

  • 階層 BindingFlags.FlattenHierarchy のメンバーと静的メンバーを含める場合は を指定します。継承されたクラスの静的 public protected private メンバーは含まれません。

検索のしくみ BindingFlags を変更するには、次の修飾子フラグを使用できます。

  • BindingFlags.IgnoreCase の大文字と小文字を無視する場合 name は 。

  • BindingFlags.DeclaredOnly 単純に継承されたプロパティではなく、 で宣言された Type プロパティのみを検索する場合は 。

詳細については、「System.Reflection.BindingFlags」を参照してください。

現在の が構築されたジェネリック型を表す場合、このメソッドは、適切な型引数に置き換えられた型パラメーターを持つ Type PropertyInfo を返します。

現在の がジェネリック型またはジェネリック メソッドの定義で型パラメーターを表している場合、このメソッドはクラス制約の Type プロパティを検索します。

次のような状況 AmbiguousMatchException が発生します。

  • 型には、同じ名前を持ち、パラメーターの数が異なる 2 つのインデックス付きプロパティが含まれています。 あいまい性を解決するには、パラメーターの型を指定する GetProperty メソッドのオーバーロードを使用します。

  • 派生型は、同じ名前の継承されたプロパティを非表示にするプロパティを宣言します。このプロパティでは、 修飾子 new ( Shadows Visual Basic)。 あいまいさを解決するには、を含めて、継承されて BindingFlags.DeclaredOnly いないメンバーに検索を限定します。

インデクサーと既定のプロパティ

Visual Basic 2005、Visual C# 2005、および Visual C++ 2005 には、インデックス付きプロパティにアクセスするための構文が簡略化されており、1つのインデックス付きプロパティをその型の既定値にすることができます。 たとえば、変数がを参照している場合、 myList ArrayList 構文 myList[3] ( myList(3) Visual Basic) は、インデックスが3の要素を取得します。 プロパティをオーバーロードすることができます。

C# では、この機能はインデクサーと呼ばれ、名前で参照することはできません。 既定では、C# インデクサーは "Item" という名前のインデックス付きプロパティとしてメタデータに表示されます。 ただし、クラスライブラリの開発者は属性を使用して、 IndexerNameAttribute メタデータ内のインデクサーの名前を変更できます。 たとえば、クラスに String はという名前のインデクサーがあり Chars[] ます。 C# 以外の言語を使用して作成されたインデックス付きプロパティには、Item 以外の名前を付けることもできます。

型に既定のプロパティがあるかどうかを判断するには、メソッドを使用して GetCustomAttributes(Type, Boolean) 属性をテストし DefaultMemberAttribute ます。 型にが含まれている場合 DefaultMemberAttributeMemberName プロパティは既定のプロパティの名前を返します。

こちらもご覧ください

適用対象

GetProperty(String, Type)

指定した名前および戻り値の型を持つパブリック プロパティを検索します。

public:
 System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType);
public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType);
public System.Reflection.PropertyInfo? GetProperty (string name, Type? returnType);
public System.Reflection.PropertyInfo GetProperty (string name, Type returnType);
member this.GetProperty : string * Type -> System.Reflection.PropertyInfo
abstract member GetProperty : string * Type -> System.Reflection.PropertyInfo
override this.GetProperty : string * Type -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, returnType As Type) As PropertyInfo

パラメーター

name
String

取得するパブリック プロパティの名前を格納している文字列。

returnType
Type

プロパティの戻り値の型。

戻り値

PropertyInfo

指定した名前のパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は null

実装

例外

指定した名前のプロパティが複数個見つかりました。

namenull であるか、または returnTypenull です。

次の例では、1つのプロパティを持つクラスを定義し、プロパティの名前と型を取得します。

using namespace System;
using namespace System::Reflection;
ref class MyClass1
{
private:
   String^ myMessage;

public:

   property String^ MyProperty1 
   {
      String^ get()
      {
         return myMessage;
      }

      void set( String^ value )
      {
         myMessage = value;
      }
   }
};

int main()
{
   try
   {
      Type^ myType = MyClass1::typeid;
      
      // Get the PropertyInfo Object* representing MyProperty1.
      PropertyInfo^ myStringProperties1 = myType->GetProperty( "MyProperty1", String::typeid );
      Console::WriteLine( "The name of the first property of MyClass1 is {0}.", myStringProperties1->Name );
      Console::WriteLine( "The type of the first property of MyClass1 is {0}.", myStringProperties1->PropertyType );
   }
   catch ( ArgumentNullException^ e ) 
   {
      Console::WriteLine( "ArgumentNullException : {0}", e->Message );
   }
   catch ( AmbiguousMatchException^ e ) 
   {
      Console::WriteLine( "AmbiguousMatchException : {0}", e->Message );
   }
   catch ( NullReferenceException^ e ) 
   {
      Console::WriteLine( "Source : {0}", e->Source );
      Console::WriteLine( "Message : {0}", e->Message );
   }
   //Output:
   //The name of the first property of MyClass1 is MyProperty1.
   //The type of the first property of MyClass1 is System.String.

}

using System;
using System.Reflection;

class MyClass1
{
    String myMessage="Hello World.";
    public string MyProperty1
    {
        get
        {			
            return myMessage;
        }
        set
        {
            myMessage =value;
        }			
    }
}
class TestClass
{
    static void Main()
    {
        try
        {	
            Type myType = typeof(MyClass1);
            // Get the PropertyInfo object representing MyProperty1.
            PropertyInfo myStringProperties1 = myType.GetProperty("MyProperty1",
                typeof(string));
            Console.WriteLine("The name of the first property of MyClass1 is {0}.", myStringProperties1.Name);
            Console.WriteLine("The type of the first property of MyClass1 is {0}.", myStringProperties1.PropertyType);
        }
        catch(ArgumentNullException e)
        {
            Console.WriteLine("ArgumentNullException :"+e.Message);
        }
        catch(AmbiguousMatchException e)
        {
            Console.WriteLine("AmbiguousMatchException :"+e.Message);
        }
        catch(NullReferenceException e)
        {
            Console.WriteLine("Source : {0}" , e.Source);
            Console.WriteLine("Message : {0}" , e.Message);
        }
    //Output:
    //The name of the first property of MyClass1 is MyProperty1.
    //The type of the first property of MyClass1 is System.String.
    }
}
Imports System.Reflection
Class MyClass1
    Private myMessage As [String] = "Hello World."
    Public Property MyProperty1() As String
        Get
            Return myMessage
        End Get
        Set(ByVal Value As String)
            myMessage = Value
        End Set
    End Property
End Class

Class TestClass
    Shared Sub Main()
        Try
            Dim myType As Type = GetType(MyClass1)
            ' Get the PropertyInfo object representing MyProperty1. 
            Dim myStringProperties1 As PropertyInfo = myType.GetProperty("MyProperty1", GetType(String))
            Console.WriteLine("The name of the first property of MyClass1 is {0}.", myStringProperties1.Name)
            Console.WriteLine("The type of the first property of MyClass1 is {0}.", myStringProperties1.PropertyType.ToString())
        Catch e As ArgumentNullException
            Console.WriteLine("ArgumentNullException :" + e.Message.ToString())
        Catch e As AmbiguousMatchException
            Console.WriteLine("AmbiguousMatchException :" + e.Message.ToString())
        Catch e As NullReferenceException
            Console.WriteLine("Source : {0}", e.Source.ToString())
            Console.WriteLine("Message : {0}", e.Message.ToString())
        End Try
    'Output:
    'The name of the first property of MyClass1 is MyProperty1.
    'The type of the first property of MyClass1 is System.String.

    End Sub
End Class

注釈

パブリックであるアクセサーが少なくとも1つある場合、プロパティはリフレクションに対してパブリックと見なされます。 それ以外の場合、プロパティはプライベートと見なされ、 BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual Basic では、を使用して値を結合 Or ) を使用して取得する必要があります。

の検索で name は、大文字と小文字が区別されます。 検索には、パブリックな静的およびパブリックインスタンスのプロパティが含まれます。

現在のが Type 構築ジェネリック型を表している場合、このメソッドは、 PropertyInfo 適切な型引数によって置き換えられた型パラメーターを持つを返します。

現在のが Type ジェネリック型またはジェネリックメソッドの定義の型パラメーターを表している場合、このメソッドはクラスの制約のプロパティを検索します。

インデクサーと既定のプロパティ

Visual Basic 2005、Visual C# 2005、および Visual C++ 2005 には、インデックス付きプロパティにアクセスするための構文が簡略化されており、1つのインデックス付きプロパティをその型の既定値にすることができます。 たとえば、変数がを参照している場合、 myList ArrayList 構文 myList[3] ( myList(3) Visual Basic) は、インデックスが3の要素を取得します。 プロパティをオーバーロードすることができます。

C# では、この機能はインデクサーと呼ばれ、名前で参照することはできません。 既定では、C# インデクサーは "Item" という名前のインデックス付きプロパティとしてメタデータに表示されます。 ただし、クラスライブラリの開発者は属性を使用して、 IndexerNameAttribute メタデータ内のインデクサーの名前を変更できます。 たとえば、クラスに String はという名前のインデクサーがあり Chars[] ます。 C# 以外の言語を使用して作成されたインデックス付きプロパティには、Item 以外の名前を付けることもできます。

型に既定のプロパティがあるかどうかを判断するには、メソッドを使用して GetCustomAttributes(Type, Boolean) 属性をテストし DefaultMemberAttribute ます。 型にが含まれている場合 DefaultMemberAttributeMemberName プロパティは既定のプロパティの名前を返します。

こちらもご覧ください

適用対象

GetProperty(String, Type[])

指定したパブリック プロパティのうち、指定した引数型と一致するパラメーターが設定されているものを検索します。

public:
 System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, cli::array <Type ^> ^ types);
public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, cli::array <Type ^> ^ types);
public System.Reflection.PropertyInfo? GetProperty (string name, Type[] types);
public System.Reflection.PropertyInfo GetProperty (string name, Type[] types);
member this.GetProperty : string * Type[] -> System.Reflection.PropertyInfo
abstract member GetProperty : string * Type[] -> System.Reflection.PropertyInfo
override this.GetProperty : string * Type[] -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, types As Type()) As PropertyInfo

パラメーター

name
String

取得するパブリック プロパティの名前を格納している文字列。

types
Type[]

取得するインデックス付きプロパティに対するパラメーターの数値、順序、および型を表す Type オブジェクトの配列。

または インデックス付けされていないプロパティを取得するための、Type 型の空の配列 (Type[] types = new Type[0])。

戻り値

PropertyInfo

指定した引数型と一致するパラメーターが設定されているパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は null

実装

例外

指定した名前を持ち引数の型が一致する複数のプロパティが存在します。

namenullです。

または typesnullです。

types が多次元です。

types の要素は null です。

次の例では、 Type ユーザー定義クラスのオブジェクトを取得し、そのクラスのプロパティを取得して、に渡された引数によって指定されたプロパティの名前と型を表示し GetProperty ます。

using namespace System;
using namespace System::Reflection;
ref class MyClass1
{
private:
   array<int, 2>^myArray;

public:

   property int Item [int, int]
   {

      // Declare an indexer.
      int get( int i, int j )
      {
         return myArray[ i,j ];
      }

      void set( int i, int j, int value )
      {
         myArray[ i,j ] = value;
      }

   }

};

int main()
{
   try
   {
      
      // Get the Type object.
      Type^ myType = MyClass1::typeid;
      array<Type^>^myTypeArr = gcnew array<Type^>(2);
      
      // Create an instance of a Type array.
      myTypeArr->SetValue( int::typeid, 0 );
      myTypeArr->SetValue( int::typeid, 1 );
      
      // Get the PropertyInfo object for the indexed property Item, which has two integer parameters.
      PropertyInfo^ myPropInfo = myType->GetProperty( "Item", myTypeArr );
      
      // Display the property.
      Console::WriteLine( "The {0} property exists in MyClass1.", myPropInfo );
   }
   catch ( NullReferenceException^ e ) 
   {
      Console::WriteLine( "An exception occurred." );
      Console::WriteLine( "Source : {0}", e->Source );
      Console::WriteLine( "Message : {0}", e->Message );
   }

}

using System;
using System.Reflection;
class MyClass1
{
    private int [,] myArray = {{1,2},{3,4}};
    // Declare an indexer.
    public int this [int i,int j]
    {
        get
        {
            return myArray[i,j];
        }
        set
        {
            myArray[i,j] = value;
        }
    }
}
public class MyTypeClass
{
    public static void Main(string[] args)
    {
        try
        {
            // Get the Type object.
            Type myType=typeof(MyClass1);
            Type[] myTypeArr = new Type[2];
            // Create an instance of a Type array.
            myTypeArr.SetValue(typeof(int),0);
            myTypeArr.SetValue(typeof(int),1);
            // Get the PropertyInfo object for the indexed property Item, which has two integer parameters.
            PropertyInfo myPropInfo = myType.GetProperty("Item", myTypeArr);
            // Display the property.
            Console.WriteLine("The {0} property exists in MyClass1.", myPropInfo.ToString());
        }
        catch(NullReferenceException e)
        {
            Console.WriteLine("An exception occurred.");
            Console.WriteLine("Source : {0}" , e.Source);
            Console.WriteLine("Message : {0}" , e.Message);
        }
    }
}
Imports System.Reflection

Module Module1
    Class MyClass1
        Private myArray As Integer(,) = {{1, 2}, {3, 4}}
        ' Declare an indexer.
        Default Public Property Item(ByVal i As Integer, ByVal j As Integer) As Integer
            Get
                Return myArray(i, j)
            End Get
            Set(ByVal Value As Integer)

                myArray(i, j) = Value
            End Set
        End Property
    End Class

    Public Class MyTypeClass
        Public Shared Sub Main()
            Try
                ' Get the Type Object.
                Dim myType As Type = GetType(MyClass1)
                Dim myTypeArr(1) As Type
                ' Create an instance of a Type array.
                myTypeArr.SetValue(GetType(Integer), 0)
                myTypeArr.SetValue(GetType(Integer), 1)
                ' Get the PropertyInfo object for the indexed property Item, which has two integer parameters. 
                Dim myPropInfo As PropertyInfo = myType.GetProperty("Item", myTypeArr)
                ' Display the property.
                Console.WriteLine("The {0} property exists in MyClass1.", myPropInfo.ToString())
            Catch e As NullReferenceException
                Console.WriteLine("An exception occurred.")
                Console.WriteLine("Source : {0}", e.Source.ToString())
                Console.WriteLine("Message : {0}", e.Message.ToString())
            End Try
        End Sub
    End Class
End Module 'Module1

注釈

パブリックであるアクセサーが少なくとも1つある場合、プロパティはリフレクションに対してパブリックと見なされます。 それ以外の場合、プロパティはプライベートと見なされ、 BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual Basic では、を使用して値を結合 Or ) を使用して取得する必要があります。

の検索で name は、大文字と小文字が区別されます。 検索には、パブリックな静的およびパブリックインスタンスのプロパティが含まれます。

現在のが Type 構築ジェネリック型を表している場合、このメソッドは、 PropertyInfo 適切な型引数によって置き換えられた型パラメーターを持つを返します。

現在のが Type ジェネリック型またはジェネリックメソッドの定義の型パラメーターを表している場合、このメソッドはクラスの制約のプロパティを検索します。

インデクサーと既定のプロパティ

Visual Basic 2005、Visual C# 2005、および Visual C++ 2005 には、インデックス付きプロパティにアクセスするための構文が簡略化されており、1つのインデックス付きプロパティをその型の既定値にすることができます。 たとえば、変数がを参照している場合、 myList ArrayList 構文 myList[3] ( myList(3) Visual Basic) は、インデックスが3の要素を取得します。 プロパティをオーバーロードすることができます。

C# では、この機能はインデクサーと呼ばれ、名前で参照することはできません。 既定では、C# インデクサーは "Item" という名前のインデックス付きプロパティとしてメタデータに表示されます。 ただし、クラスライブラリの開発者は属性を使用して、 IndexerNameAttribute メタデータ内のインデクサーの名前を変更できます。 たとえば、クラスに String はという名前のインデクサーがあり Chars[] ます。 C# 以外の言語を使用して作成されたインデックス付きプロパティには、Item 以外の名前を付けることもできます。

型に既定のプロパティがあるかどうかを判断するには、メソッドを使用して GetCustomAttributes(Type, Boolean) 属性をテストし DefaultMemberAttribute ます。 型にが含まれている場合 DefaultMemberAttributeMemberName プロパティは既定のプロパティの名前を返します。

こちらもご覧ください

適用対象

GetProperty(String, Type, Type[])

指定したパブリック プロパティのうち、指定した引数型と一致するパラメーターが設定されているものを検索します。

public:
 System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ types);
public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ types);
public System.Reflection.PropertyInfo? GetProperty (string name, Type? returnType, Type[] types);
public System.Reflection.PropertyInfo GetProperty (string name, Type returnType, Type[] types);
member this.GetProperty : string * Type * Type[] -> System.Reflection.PropertyInfo
abstract member GetProperty : string * Type * Type[] -> System.Reflection.PropertyInfo
override this.GetProperty : string * Type * Type[] -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, returnType As Type, types As Type()) As PropertyInfo

パラメーター

name
String

取得するパブリック プロパティの名前を格納している文字列。

returnType
Type

プロパティの戻り値の型。

types
Type[]

取得するインデックス付きプロパティに対するパラメーターの数値、順序、および型を表す Type オブジェクトの配列。

または インデックス付けされていないプロパティを取得するための、Type 型の空の配列 (Type[] types = new Type[0])。

戻り値

PropertyInfo

指定した引数型と一致するパラメーターが設定されているパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は null

実装

例外

指定した名前を持ち引数の型が一致する複数のプロパティが存在します。

namenullです。

または typesnullです。

types が多次元です。

types の要素は null です。

注釈

パブリックであるアクセサーが少なくとも1つある場合、プロパティはリフレクションに対してパブリックと見なされます。 それ以外の場合、プロパティはプライベートと見なされ、 BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual Basic では、を使用して値を結合 Or ) を使用して取得する必要があります。

の検索で name は、大文字と小文字が区別されます。 検索には、パブリックな静的およびパブリックインスタンスのプロパティが含まれます。

現在のが Type 構築ジェネリック型を表している場合、このメソッドは、 PropertyInfo 適切な型引数によって置き換えられた型パラメーターを持つを返します。

現在のが Type ジェネリック型またはジェネリックメソッドの定義の型パラメーターを表している場合、このメソッドはクラスの制約のプロパティを検索します。

インデクサーと既定のプロパティ

Visual Basic 2005、Visual C# 2005、および Visual C++ 2005 には、インデックス付きプロパティにアクセスするための構文が簡略化されており、1つのインデックス付きプロパティをその型の既定値にすることができます。 たとえば、変数がを参照している場合、 myList ArrayList 構文 myList[3] ( myList(3) Visual Basic) は、インデックスが3の要素を取得します。 プロパティをオーバーロードすることができます。

C# では、この機能はインデクサーと呼ばれ、名前で参照することはできません。 既定では、C# インデクサーは "Item" という名前のインデックス付きプロパティとしてメタデータに表示されます。 ただし、クラスライブラリの開発者は属性を使用して、 IndexerNameAttribute メタデータ内のインデクサーの名前を変更できます。 たとえば、クラスに String はという名前のインデクサーがあり Chars[] ます。 C# 以外の言語を使用して作成されたインデックス付きプロパティには、Item 以外の名前を付けることもできます。

型に既定のプロパティがあるかどうかを判断するには、メソッドを使用して GetCustomAttributes(Type, Boolean) 属性をテストし DefaultMemberAttribute ます。 型にが含まれている場合 DefaultMemberAttributeMemberName プロパティは既定のプロパティの名前を返します。

こちらもご覧ください

適用対象

GetProperty(String, Type, Type[], ParameterModifier[])

指定したパブリック プロパティのうち、指定した引数の型および修飾子と一致するパラメーターが設定されているものを検索します。

public:
 System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public System.Reflection.PropertyInfo? GetProperty (string name, Type? returnType, Type[] types, System.Reflection.ParameterModifier[]? modifiers);
public System.Reflection.PropertyInfo GetProperty (string name, Type returnType, Type[] types, System.Reflection.ParameterModifier[] modifiers);
member this.GetProperty : string * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo
abstract member GetProperty : string * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo
override this.GetProperty : string * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, returnType As Type, types As Type(), modifiers As ParameterModifier()) As PropertyInfo

パラメーター

name
String

取得するパブリック プロパティの名前を格納している文字列。

returnType
Type

プロパティの戻り値の型。

types
Type[]

取得するインデックス付きプロパティに対するパラメーターの数値、順序、および型を表す Type オブジェクトの配列。

または インデックス付けされていないプロパティを取得するための、Type 型の空の配列 (Type[] types = new Type[0])。

modifiers
ParameterModifier[]

types 配列内の対応する要素に関連付けられている属性を表す ParameterModifier オブジェクトの配列。 既定のバインダーでは、このパラメーターは処理されません。

戻り値

PropertyInfo

指定した要件と一致するパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は null

実装

例外

指定された名前を持ち、指定された引数の型および修飾子に一致する 2 つ以上のプロパティが存在します。

namenullです。

または typesnullです。

types が多次元です。

または modifiers が多次元です。

または typesmodifiers の長さが同じではありません。

types の要素は null です。

次の例では Type 、に対応するオブジェクトを取得 MyPropertyClass します。このクラスのインデックス付きプロパティは、メソッドに渡される引数を使用して取得され GetProperty ます。

using namespace System;
using namespace System::Reflection;
public ref class MyPropertyClass
{
private:
   array<int, 2>^ myPropertyArray;

public:

   property int Item [int, int]
   {
      // Declare an indexer.
      int get( int i, int j )
      {
         return myPropertyArray[ i,j ];
      }

      void set( int i, int j, int value )
      {
         myPropertyArray[ i,j ] = value;
      }

   }

};

int main()
{
   try
   {
      Type^ myType = MyPropertyClass::typeid;
      array<Type^>^myTypeArray = gcnew array<Type^>(2);
      
      // Create an instance of the Type array representing the number, order
      // and type of the parameters for the property.
      myTypeArray->SetValue( int::typeid, 0 );
      myTypeArray->SetValue( int::typeid, 1 );
      
      // Search for the indexed property whose parameters match the
      // specified argument types and modifiers.
      PropertyInfo^ myPropertyInfo = myType->GetProperty( "Item", int::typeid, myTypeArray, nullptr );
      Console::WriteLine( "{0}.{1} has a property type of {2}", myType->FullName, myPropertyInfo->Name, myPropertyInfo->PropertyType );
   }
   catch ( Exception^ ex ) 
   {
      Console::WriteLine( "An exception occurred {0}", ex->Message );
   }

}
using System;
using System.Reflection;
public class MyPropertyClass
{
    private int [,] myPropertyArray = new int[10,10];
    // Declare an indexer.
    public int this [int i,int j]
    {
        get
        {
            return myPropertyArray[i,j];
        }
        set
        {
            myPropertyArray[i,j] = value;
        }
    }
}
public class MyTypeClass
{
    public static void Main()
    {
        try
        {
            Type myType=typeof(MyPropertyClass);
            Type[] myTypeArray = new Type[2];
            // Create an instance of the Type array representing the number, order
            // and type of the parameters for the property.
            myTypeArray.SetValue(typeof(int),0);
            myTypeArray.SetValue(typeof(int),1);
            // Search for the indexed property whose parameters match the
            // specified argument types and modifiers.
            PropertyInfo myPropertyInfo = myType.GetProperty("Item",
                typeof(int),myTypeArray,null);
            Console.WriteLine(myType.FullName + "." + myPropertyInfo.Name +
                " has a property type of " + myPropertyInfo.PropertyType);
         }
        catch(Exception ex)
        {
            Console.WriteLine("An exception occurred " + ex.Message);
        }
    }
}
Imports System.Reflection

Public Class MyPropertyClass
    Private myPropertyArray(9, 9) As Integer
    ' Declare an indexer.
    Default Public Property Item(ByVal i As Integer, ByVal j As Integer) As Integer
        Get
            Return myPropertyArray(i, j)
        End Get
        Set(ByVal Value As Integer)
            myPropertyArray(i, j) = Value
        End Set
    End Property
End Class

Public Class MyTypeClass
    Public Shared Sub Main()
        Try
            Dim myType As Type = GetType(MyPropertyClass)
            Dim myTypeArray(1) As Type
            ' Create an instance of a Type array representing the number, order 
            ' and type of the parameters for the property.
            myTypeArray.SetValue(GetType(Integer), 0)
            myTypeArray.SetValue(GetType(Integer), 1)
            ' Search for the indexed property whose parameters match the
            ' specified argument types and modifiers.
            Dim myPropertyInfo As PropertyInfo = myType.GetProperty("Item", _
                  GetType(Integer), myTypeArray, Nothing)
            Console.WriteLine(myType.FullName + "." + myPropertyInfo.Name + _
                  " has a property  type of " + myPropertyInfo.PropertyType.ToString())
        Catch ex As Exception
            Console.WriteLine("An exception occurred " + ex.Message.ToString())
        End Try
    End Sub
End Class

注釈

パブリックであるアクセサーが少なくとも1つある場合、プロパティはリフレクションに対してパブリックと見なされます。 それ以外の場合、プロパティはプライベートと見なされ、 BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual Basic では、を使用して値を結合 Or ) を使用して取得する必要があります。

既定のバインダーでは (パラメーター) は処理されませんが ParameterModifier modifiers 、抽象クラスを使用し System.Reflection.Binder て、処理を実行するカスタムバインダーを書き込むことができ modifiers ます。 ParameterModifier は COM 相互運用機能を使用してを呼び出す場合にのみ使用され、参照によって渡されるパラメーターのみが処理されます。

の検索で name は、大文字と小文字が区別されます。 検索には、パブリックな静的およびパブリックインスタンスのプロパティが含まれます。

現在のが Type 構築ジェネリック型を表している場合、このメソッドは、 PropertyInfo 適切な型引数によって置き換えられた型パラメーターを持つを返します。

現在のが Type ジェネリック型またはジェネリックメソッドの定義の型パラメーターを表している場合、このメソッドはクラスの制約のプロパティを検索します。

インデクサーと既定のプロパティ

Visual Basic 2005、Visual C# 2005、および Visual C++ 2005 には、インデックス付きプロパティにアクセスするための構文が簡略化されており、1つのインデックス付きプロパティをその型の既定値にすることができます。 たとえば、変数がを参照している場合、 myList ArrayList 構文 myList[3] ( myList(3) Visual Basic) は、インデックスが3の要素を取得します。 プロパティをオーバーロードすることができます。

C# では、この機能はインデクサーと呼ばれ、名前で参照することはできません。 既定では、C# インデクサーは "Item" という名前のインデックス付きプロパティとしてメタデータに表示されます。 ただし、クラスライブラリの開発者は属性を使用して、 IndexerNameAttribute メタデータ内のインデクサーの名前を変更できます。 たとえば、クラスに String はという名前のインデクサーがあり Chars[] ます。 C# 以外の言語を使用して作成されたインデックス付きプロパティには、Item 以外の名前を付けることもできます。

型に既定のプロパティがあるかどうかを判断するには、メソッドを使用して GetCustomAttributes(Type, Boolean) 属性をテストし DefaultMemberAttribute ます。 型にが含まれている場合 DefaultMemberAttributeMemberName プロパティは既定のプロパティの名前を返します。

こちらもご覧ください

適用対象