Type.GetProperty メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在の 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
取得するプロパティの名前を格納している文字列。
- binder
- Binder
一連のプロパティを定義し、バインディングを有効にするオブジェクト。バインディングには、オーバーロードされたメソッドの選択、引数の型の強制変換、リフレクションによるメンバーの呼び出しなどが含まれます。
または
Nothing
を使用する場合は、null 参照 (Visual Basic の場合は DefaultBinder)。
- returnType
- Type
プロパティの戻り値の型。
- types
- Type[]
取得するインデックス付きプロパティに対するパラメーターの数値、順序、および型を表す Type オブジェクトの配列。
または インデックス付けされていないプロパティを取得するための、Type 型の空の配列 (Type[] types = new Type[0])。
- modifiers
- ParameterModifier[]
types
配列内の対応する要素に関連付けられている属性を表す ParameterModifier オブジェクトの配列。 既定のバインダーでは、このパラメーターは処理されません。
戻り値
指定した要件と一致するプロパティが存在する場合は、そのプロパティを表すオブジェクト。それ以外の場合は null
。
実装
例外
指定された名前を持ち、指定されたバインディング制約に一致する 1 つ以上のプロパティが存在します。
types
の要素は null
です。
注釈
パブリックであるアクセサーが少なくとも1つある場合、プロパティはリフレクションに対してパブリックと見なされます。 それ以外の場合、プロパティはプライベートと見なされ、 BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual Basic では、を使用して値を結合 Or
) を使用して取得する必要があります。
既定のバインダーでは (パラメーター) は処理されませんが ParameterModifier modifiers
、抽象クラスを使用し System.Reflection.Binder て、処理を実行するカスタムバインダーを書き込むことができ modifiers
ます。 ParameterModifier
は COM 相互運用機能を使用してを呼び出す場合にのみ使用され、参照によって渡されるパラメーターのみが処理されます。
次の表は、型に対してリフレクションを行うときに、メソッドによって返される基底クラスのメンバーを示してい Get
ます。
メンバーの型 | 静的 | 非静的 |
---|---|---|
コンストラクター | いいえ | いいえ |
フィールド | いいえ | はい。 フィールドは、常に名前と署名で隠ぺいされます。 |
Event | 適用なし | 共通型システムの規則は、継承が、プロパティを実装するメソッドと同じであることを示します。 リフレクションは、プロパティを名前で隠す、署名として扱います。 下記のメモ2を参照してください。 |
メソッド | いいえ | はい。 メソッド (仮想と非仮想の両方) は、非表示にするか、名前と署名を隠すことができます。 |
入れ子にされた型 | いいえ | いいえ |
プロパティ | 適用なし | 共通型システムの規則は、継承が、プロパティを実装するメソッドと同じであることを示します。 リフレクションは、プロパティを名前で隠す、署名として扱います。 下記のメモ2を参照してください。 |
名前による隠ぺいと署名では、カスタム修飾子、戻り値の型、パラメーターの型、sentinel、アンマネージ呼び出し規約を含む、シグネチャのすべての部分が考慮されます。 これは、バイナリ比較です。
リフレクションの場合、プロパティとイベントは、名前とシグネチャが隠ぺいされます。 基底クラスに get と set の両方のアクセサーを持つプロパティがあり、派生クラスに get アクセサーのみがある場合、派生クラスのプロパティは基底クラスのプロパティを非表示にします。基底クラスの setter にアクセスすることはできません。
カスタム属性は、共通型システムの一部ではありません。
次の 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 ます。 型にが含まれている場合 DefaultMemberAttribute 、 MemberName プロパティは既定のプロパティの名前を返します。
こちらもご覧ください
- PropertyInfo
- String
- BindingFlags
- Binder
- DefaultBinder
- ParameterModifier
- GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- GetProperties(BindingFlags)
適用対象
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
取得するパブリック プロパティの名前を格納している文字列。
戻り値
指定した名前のパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は null
。
実装
例外
指定した名前のプロパティが複数個見つかりました。
name
が null
です。
例
次の例では、ユーザー定義クラスの オブジェクトを取得し、そのクラスの プロパティを取得して、 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 は既定のプロパティの名前を返します。
こちらもご覧ください
- PropertyInfo
- String
- DefaultBinder
- GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- GetProperties(BindingFlags)
適用対象
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
取得するプロパティの名前を格納している文字列。
戻り値
指定した要件と一致するプロパティが存在する場合は、そのプロパティを表すオブジェクト。それ以外の場合は null
。
実装
例外
指定された名前を持ち、指定されたバインディング制約に一致する 1 つ以上のプロパティが存在します。
name
が null
です。
例
次の例では、ユーザー定義クラスの型を取得し、そのクラスのプロパティを取得して、指定されたバインディング制約に従ってプロパティ名を表示します。
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 ます。 型にが含まれている場合 DefaultMemberAttribute 、 MemberName プロパティは既定のプロパティの名前を返します。
こちらもご覧ください
- PropertyInfo
- String
- BindingFlags
- DefaultBinder
- GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- GetProperties(BindingFlags)
適用対象
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
プロパティの戻り値の型。
戻り値
指定した名前のパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は null
。
実装
例外
指定した名前のプロパティが複数個見つかりました。
name
が null
であるか、または returnType
が null
です。
例
次の例では、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 ます。 型にが含まれている場合 DefaultMemberAttribute 、 MemberName プロパティは既定のプロパティの名前を返します。
こちらもご覧ください
- PropertyInfo
- String
- DefaultBinder
- GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- GetProperties(BindingFlags)
適用対象
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])。
戻り値
指定した引数型と一致するパラメーターが設定されているパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は null
。
実装
例外
指定した名前を持ち引数の型が一致する複数のプロパティが存在します。
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 ます。 型にが含まれている場合 DefaultMemberAttribute 、 MemberName プロパティは既定のプロパティの名前を返します。
こちらもご覧ください
- PropertyInfo
- String
- DefaultBinder
- GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- GetProperties(BindingFlags)
適用対象
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])。
戻り値
指定した引数型と一致するパラメーターが設定されているパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は null
。
実装
例外
指定した名前を持ち引数の型が一致する複数のプロパティが存在します。
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 ます。 型にが含まれている場合 DefaultMemberAttribute 、 MemberName プロパティは既定のプロパティの名前を返します。
こちらもご覧ください
- PropertyInfo
- String
- DefaultBinder
- GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- GetProperties(BindingFlags)
適用対象
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 オブジェクトの配列。 既定のバインダーでは、このパラメーターは処理されません。
戻り値
指定した要件と一致するパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は null
。
実装
例外
指定された名前を持ち、指定された引数の型および修飾子に一致する 2 つ以上のプロパティが存在します。
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 ます。 型にが含まれている場合 DefaultMemberAttribute 、 MemberName プロパティは既定のプロパティの名前を返します。
こちらもご覧ください
- PropertyInfo
- String
- DefaultBinder
- ParameterModifier
- GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- GetProperties(BindingFlags)