Type.GetProperty Type.GetProperty Type.GetProperty Type.GetProperty Method

定義

現在の Type の特定のプロパティを取得します。Gets a specific property of the current Type.

オーバーロード

GetProperty(String) GetProperty(String) GetProperty(String) GetProperty(String)

指定した名前のパブリック プロパティを検索します。Searches for the public property with the specified name.

GetProperty(String, BindingFlags) GetProperty(String, BindingFlags) GetProperty(String, BindingFlags) GetProperty(String, BindingFlags)

指定されたバインディング制約を使用して、指定されたプロパティを検索します。Searches for the specified property, using the specified binding constraints.

GetProperty(String, Type) GetProperty(String, Type) GetProperty(String, Type) GetProperty(String, Type)

指定した名前および戻り値の型を持つパブリック プロパティを検索します。Searches for the public property with the specified name and return type.

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

指定したパブリック プロパティのうち、指定した引数型と一致するパラメーターが設定されているものを検索します。Searches for the specified public property whose parameters match the specified argument types.

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

指定したパブリック プロパティのうち、指定した引数型と一致するパラメーターが設定されているものを検索します。Searches for the specified public property whose parameters match the specified argument types.

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

指定したパブリック プロパティのうち、指定した引数の型および修飾子と一致するパラメーターが設定されているものを検索します。Searches for the specified public property whose parameters match the specified argument types and modifiers.

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

指定したバインディング制約を使用して、指定した引数の型および修飾子と一致するパラメーターが設定された指定のプロパティを検索します。Searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints.

GetProperty(String) GetProperty(String) GetProperty(String) GetProperty(String)

指定した名前のパブリック プロパティを検索します。Searches for the public property with the specified name.

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

パラメーター

name
String String String String

取得するパブリック プロパティの名前を格納している文字列。The string containing the name of the public property to get.

戻り値

指定した名前のパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は nullAn object representing the public property with the specified name, if found; otherwise, null.

実装

例外

指定した名前のプロパティが複数個見つかりました。More than one property is found with the specified name.

次の例では、取得、Typeユーザー定義のクラスのオブジェクトは、そのクラスのプロパティを取得し、プロパティ名が表示されます。The following example retrieves the Type object of a user-defined class, retrieves a property of that class, and displays the property name.

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
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 'MyClass1

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 'Main
End Class 'MyTypeClass 

内部的には、このプロパティは、メタデータで名前によって参照する、"Item"にします。Internally, this property is referred to in the metadata by the name "Item." 取得しようとPropertyInfoリフレクションを使用して正しくを返すためにこの内部名を指定する必要があります、PropertyInfoプロパティ。Any attempt to get PropertyInfo using reflection must specify this internal name in order to correctly return the PropertyInfo property.

注釈

検索name小文字が区別されます。The search for name is case-sensitive. 検索には、パブリック static および public インスタンスのプロパティが含まれています。The search includes public static and public instance properties.

プロパティは公開されている少なくとも 1 つのアクセサーがある場合、リフレクションには、パブリックと見なされます。A property is considered public to reflection if it has at least one accessor that is public. それ以外の場合、プロパティは、プライベートと見なされ、使用する必要がありますBindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual basic での結合を使用して値Or) を取得します。Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

場合、現在Typeこのメソッドが戻る構築されたジェネリック型を表す、PropertyInfo適切な型引数に置き換え、型パラメーター。If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

場合、現在Type型パラメーターを表すジェネリック型またはジェネリック メソッドの定義では、このメソッドは、クラス制約のプロパティを検索します。If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

状況はAmbiguousMatchExceptionが発生した、次が含まれます。Situations in which AmbiguousMatchException occurs include the following:

  • 2 つが格納される型が同じであるインデックス付きプロパティが異なる数のパラメーターの名前します。A type contains two indexed properties that have the same name but different numbers of parameters. あいまいさを解決するには、オーバー ロードを使用して、GetPropertyパラメーターの型を指定するメソッド。To resolve the ambiguity, use an overload of the GetProperty method that specifies parameter types.

  • 派生型を使用して、同じ名前の継承されたプロパティを非表示にするプロパティを宣言する、new修飾子 (Shadows Visual Basic で)。A derived type declares a property that hides an inherited property with the same name, by using the new modifier (Shadows in Visual Basic). あいまいさを解決するには、使用、GetProperty(String, BindingFlags)メソッドのオーバー ロードを追加、BindingFlags.DeclaredOnlyは継承されないメンバーに、検索を制限するフラグ。To resolve the ambiguity, use the GetProperty(String, BindingFlags) method overload and add the BindingFlags.DeclaredOnly flag to restrict the search to members that are not inherited.

インデクサーと既定のプロパティIndexers and Default Properties

Visual Basic 2005Visual Basic 2005Visual C# 2005Visual C# 2005、およびVisual C++ 2005Visual C++ 2005インデックス付きプロパティにアクセスするための構文が簡素化され、その型の既定値にする 1 つのインデックス付きプロパティを許可します。, Visual C# 2005Visual C# 2005, and Visual C++ 2005Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. たとえば場合、変数myListを指す、 ArrayList、構文myList[3](myList(3) Visual Basic で) 3 のインデックスを持つ要素を取得します。For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. プロパティをオーバー ロードすることができます。You can overload the property.

C#、この機能は、インデクサーは呼び出され、名前によって参照することはできません。In C#, this feature is called an indexer and cannot be referred to by name. 既定では、c# インデクサーが"Item"という名前のインデックス付きプロパティとしてメタデータに表示されます。By default, a C# indexer appears in metadata as an indexed property named "Item". ただし、クラス ライブラリの開発者が使用できます、IndexerNameAttributeメタデータでインデクサーの名前を変更する属性。However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. たとえば、Stringクラスという名前のインデクサーには、Chars[Range]します。For example, the String class has an indexer named Chars[Range]. C# 以外の言語を使用して作成されたインデックス付きプロパティには、項目、以外の名前もことができます。Indexed properties created using languages other than C# can have names other than Item, as well.

型が既定のプロパティを持つかどうかを調べるには、GetCustomAttributes(Type, Boolean)メソッドをテストするため、DefaultMemberAttribute属性。To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. 型がDefaultMemberAttributeMemberNameプロパティが既定のプロパティの名前を返します。If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

こちらもご覧ください

GetProperty(String, BindingFlags) GetProperty(String, BindingFlags) GetProperty(String, BindingFlags) GetProperty(String, BindingFlags)

指定されたバインディング制約を使用して、指定されたプロパティを検索します。Searches for the specified property, using the specified binding constraints.

public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::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 String String String

取得するプロパティの名前を格納している文字列。The string containing the name of the property to get.

bindingAttr
BindingFlags BindingFlags BindingFlags BindingFlags

検索を実施する方法を指定する列挙値のビットごとの組み合わせ。A bitwise combination of the enumeration values that specify how the search is conducted.

または-or- null を返す場合は DefaultDefault to return null.

戻り値

指定した要件と一致するプロパティが存在する場合は、そのプロパティを表すオブジェクト。それ以外の場合は nullAn object representing the property that matches the specified requirements, if found; otherwise, null.

実装

例外

指定された名前を持ち、指定されたバインディング制約に一致する 1 つ以上のプロパティが存在します。More than one property is found with the specified name and matching the specified binding constraints.

次の例では、ユーザー定義のクラスの型を取得、そのクラスのプロパティを取得し、指定したバインディング制約に一致するプロパティ名が表示されます。The following example retrieves the type of a user-defined class, retrieves a property of that class and displays the property name in accordance with the specified binding constraints.

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
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 'Main
    End Class 'MyClass1
End Module 'Module1

注釈

プロパティは公開されている少なくとも 1 つのアクセサーがある場合、リフレクションには、パブリックと見なされます。A property is considered public to reflection if it has at least one accessor that is public. それ以外の場合、プロパティは、プライベートと見なされ、使用する必要がありますBindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual basic での結合を使用して値Or) を取得します。Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

BindingFlagsフィルター フラグは、検索に含めるプロパティを定義するために使用できます。The following BindingFlags filter flags can be used to define which properties to include in the search:

  • いずれかを指定する必要がありますBindingFlags.InstanceまたはBindingFlags.Static戻り値を取得するためにします。You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.

  • 指定BindingFlags.Public検索にパブリック プロパティを含めます。Specify BindingFlags.Public to include public properties in the search.

  • 指定BindingFlags.NonPublic検索に非パブリック プロパティ (つまり、プライベート、内部、および保護されているプロパティ) を含めます。Specify BindingFlags.NonPublic to include non-public properties (that is, private, internal, and protected properties) in the search.

  • 指定BindingFlags.FlattenHierarchyに含めるpublicprotected階層; の静的メンバーprivate継承クラスの静的メンバーは含まれません。Specify BindingFlags.FlattenHierarchy to include public and protected static members up the hierarchy; private static members in inherited classes are not included.

BindingFlags修飾フラグは、検索の動作を変更するために使用できます。The following BindingFlags modifier flags can be used to change how the search works:

  • BindingFlags.IgnoreCase 大文字と小文字を無視するnameします。BindingFlags.IgnoreCase to ignore the case of name.

  • BindingFlags.DeclaredOnly 宣言されたプロパティのみを検索する、 Type、単に継承されたプロパティではなく。BindingFlags.DeclaredOnly to search only the properties declared on the Type, not properties that were simply inherited.

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

場合、現在Typeこのメソッドが戻る構築されたジェネリック型を表す、PropertyInfo適切な型引数に置き換え、型パラメーター。If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

場合、現在Type型パラメーターを表すジェネリック型またはジェネリック メソッドの定義では、このメソッドは、クラス制約のプロパティを検索します。If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

状況はAmbiguousMatchExceptionが発生した、次が含まれます。Situations in which AmbiguousMatchException occurs include the following:

  • 2 つが格納される型が同じであるインデックス付きプロパティが異なる数のパラメーターの名前します。A type contains two indexed properties that have the same name but different numbers of parameters. あいまいさを解決するには、オーバー ロードを使用して、GetPropertyパラメーターの型を指定するメソッド。To resolve the ambiguity, use an overload of the GetProperty method that specifies parameter types.

  • 派生型が継承されたプロパティを同じ名前を非表示にするプロパティを宣言を使用して、new修飾子 (Shadows Visual Basic で)。A derived type declares a property that hides an inherited property with the same name, using the new modifier (Shadows in Visual Basic). あいまいさを解決するには、含めるBindingFlags.DeclaredOnly継承されていないメンバーへの検索を制限します。To resolve the ambiguity, include BindingFlags.DeclaredOnly to restrict the search to members that are not inherited.

インデクサーと既定のプロパティIndexers and Default Properties

Visual Basic 2005Visual Basic 2005Visual C# 2005Visual C# 2005、およびVisual C++ 2005Visual C++ 2005インデックス付きプロパティにアクセスするための構文が簡素化され、その型の既定値にする 1 つのインデックス付きプロパティを許可します。, Visual C# 2005Visual C# 2005, and Visual C++ 2005Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. たとえば場合、変数myListを指す、 ArrayList、構文myList[3](myList(3) Visual Basic で) 3 のインデックスを持つ要素を取得します。For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. プロパティをオーバー ロードすることができます。You can overload the property.

C#、この機能は、インデクサーは呼び出され、名前によって参照することはできません。In C#, this feature is called an indexer and cannot be referred to by name. 既定では、c# インデクサーが"Item"という名前のインデックス付きプロパティとしてメタデータに表示されます。By default, a C# indexer appears in metadata as an indexed property named "Item". ただし、クラス ライブラリの開発者が使用できます、IndexerNameAttributeメタデータでインデクサーの名前を変更する属性。However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. たとえば、Stringクラスという名前のインデクサーには、Chars[Range]します。For example, the String class has an indexer named Chars[Range]. C# 以外の言語を使用して作成されたインデックス付きプロパティには、項目、以外の名前もことができます。Indexed properties created using languages other than C# can have names other than Item, as well.

型が既定のプロパティを持つかどうかを調べるには、GetCustomAttributes(Type, Boolean)メソッドをテストするため、DefaultMemberAttribute属性。To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. 型がDefaultMemberAttributeMemberNameプロパティが既定のプロパティの名前を返します。If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

こちらもご覧ください

GetProperty(String, Type) GetProperty(String, Type) GetProperty(String, Type) GetProperty(String, Type)

指定した名前および戻り値の型を持つパブリック プロパティを検索します。Searches for the public property with the specified name and return type.

public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType);
public System.Reflection.PropertyInfo GetProperty (string name, Type returnType);
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 String String String

取得するパブリック プロパティの名前を格納している文字列。The string containing the name of the public property to get.

returnType
Type Type Type Type

プロパティの戻り値の型。The return type of the property.

戻り値

指定した名前のパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は nullAn object representing the public property with the specified name, if found; otherwise, null.

実装

例外

指定した名前のプロパティが複数個見つかりました。More than one property is found with the specified name.

namenull であるか、または returnTypenull です。name is null, or returnType is null.

次の例では、1 つのプロパティを持つクラスを定義し、プロパティの型と名前を取得します。The following example defines a class with one property and retrieves the name and type of the property.

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
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 'MyClass1

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 'Main
End Class 'TestClass

注釈

プロパティは公開されている少なくとも 1 つのアクセサーがある場合、リフレクションには、パブリックと見なされます。A property is considered public to reflection if it has at least one accessor that is public. それ以外の場合、プロパティは、プライベートと見なされ、使用する必要がありますBindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual basic での結合を使用して値Or) を取得します。Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

検索name小文字が区別されます。The search for name is case-sensitive. 検索には、パブリック static および public インスタンスのプロパティが含まれています。The search includes public static and public instance properties.

場合、現在Typeこのメソッドが戻る構築されたジェネリック型を表す、PropertyInfo適切な型引数に置き換え、型パラメーター。If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

場合、現在Type型パラメーターを表すジェネリック型またはジェネリック メソッドの定義では、このメソッドは、クラス制約のプロパティを検索します。If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

インデクサーと既定のプロパティIndexers and Default Properties

Visual Basic 2005Visual Basic 2005Visual C# 2005Visual C# 2005、およびVisual C++ 2005Visual C++ 2005インデックス付きプロパティにアクセスするための構文が簡素化され、その型の既定値にする 1 つのインデックス付きプロパティを許可します。, Visual C# 2005Visual C# 2005, and Visual C++ 2005Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. たとえば場合、変数myListを指す、 ArrayList、構文myList[3](myList(3) Visual Basic で) 3 のインデックスを持つ要素を取得します。For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. プロパティをオーバー ロードすることができます。You can overload the property.

C#、この機能は、インデクサーは呼び出され、名前によって参照することはできません。In C#, this feature is called an indexer and cannot be referred to by name. 既定では、c# インデクサーが"Item"という名前のインデックス付きプロパティとしてメタデータに表示されます。By default, a C# indexer appears in metadata as an indexed property named "Item". ただし、クラス ライブラリの開発者が使用できます、IndexerNameAttributeメタデータでインデクサーの名前を変更する属性。However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. たとえば、Stringクラスという名前のインデクサーには、Chars[Range]します。For example, the String class has an indexer named Chars[Range]. C# 以外の言語を使用して作成されたインデックス付きプロパティには、項目、以外の名前もことができます。Indexed properties created using languages other than C# can have names other than Item, as well.

型が既定のプロパティを持つかどうかを調べるには、GetCustomAttributes(Type, Boolean)メソッドをテストするため、DefaultMemberAttribute属性。To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. 型がDefaultMemberAttributeMemberNameプロパティが既定のプロパティの名前を返します。If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

こちらもご覧ください

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

指定したパブリック プロパティのうち、指定した引数型と一致するパラメーターが設定されているものを検索します。Searches for the specified public property whose parameters match the specified argument types.

public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, cli::array <Type ^> ^ types);
public System.Reflection.PropertyInfo GetProperty (string name, Type[] types);
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 String String String

取得するパブリック プロパティの名前を格納している文字列。The string containing the name of the public property to get.

types
Type[]

取得するインデックス付きプロパティに対するパラメーターの数値、順序、および型を表す Type オブジェクトの配列。An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

または-or- インデックス付けされていないプロパティを取得するための、Type 型の空の配列 (Type[] types = new Type[0])。An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

戻り値

指定した引数型と一致するパラメーターが設定されているパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は nullAn object representing the public property whose parameters match the specified argument types, if found; otherwise, null.

実装

例外

指定した名前を持ち引数の型が一致する複数のプロパティが存在します。More than one property is found with the specified name and matching the specified argument types.

namenullです。name is null.

- または --or- typesnullです。types is null.

types が多次元です。types is multidimensional.

types の要素は null です。An element of types is null.

次の例では、取得、Typeユーザー定義のクラスのオブジェクトは、そのクラスのプロパティを取得しに渡される引数で指定されたプロパティ名とプロパティの型を表示しますGetPropertyします。The following example retrieves the Type object of a user-defined class, retrieves the property of that class, and displays the property name and type of the property as specified by the arguments passed to 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
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 'MyClass1

    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 'Main
    End Class 'MyTypeClass
End Module 'Module1

注釈

プロパティは公開されている少なくとも 1 つのアクセサーがある場合、リフレクションには、パブリックと見なされます。A property is considered public to reflection if it has at least one accessor that is public. それ以外の場合、プロパティは、プライベートと見なされ、使用する必要がありますBindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual basic での結合を使用して値Or) を取得します。Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

検索name小文字が区別されます。The search for name is case-sensitive. 検索には、パブリック static および public インスタンスのプロパティが含まれています。The search includes public static and public instance properties.

場合、現在Typeこのメソッドが戻る構築されたジェネリック型を表す、PropertyInfo適切な型引数に置き換え、型パラメーター。If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

場合、現在Type型パラメーターを表すジェネリック型またはジェネリック メソッドの定義では、このメソッドは、クラス制約のプロパティを検索します。If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

インデクサーと既定のプロパティIndexers and Default Properties

Visual Basic 2005Visual Basic 2005Visual C# 2005Visual C# 2005、およびVisual C++ 2005Visual C++ 2005インデックス付きプロパティにアクセスするための構文が簡素化され、その型の既定値にする 1 つのインデックス付きプロパティを許可します。, Visual C# 2005Visual C# 2005, and Visual C++ 2005Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. たとえば場合、変数myListを指す、 ArrayList、構文myList[3](myList(3) Visual Basic で) 3 のインデックスを持つ要素を取得します。For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. プロパティをオーバー ロードすることができます。You can overload the property.

C#、この機能は、インデクサーは呼び出され、名前によって参照することはできません。In C#, this feature is called an indexer and cannot be referred to by name. 既定では、c# インデクサーが"Item"という名前のインデックス付きプロパティとしてメタデータに表示されます。By default, a C# indexer appears in metadata as an indexed property named "Item". ただし、クラス ライブラリの開発者が使用できます、IndexerNameAttributeメタデータでインデクサーの名前を変更する属性。However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. たとえば、Stringクラスという名前のインデクサーには、Chars[Range]します。For example, the String class has an indexer named Chars[Range]. C# 以外の言語を使用して作成されたインデックス付きプロパティには、項目、以外の名前もことができます。Indexed properties created using languages other than C# can have names other than Item, as well.

型が既定のプロパティを持つかどうかを調べるには、GetCustomAttributes(Type, Boolean)メソッドをテストするため、DefaultMemberAttribute属性。To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. 型がDefaultMemberAttributeMemberNameプロパティが既定のプロパティの名前を返します。If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

こちらもご覧ください

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

指定したパブリック プロパティのうち、指定した引数型と一致するパラメーターが設定されているものを検索します。Searches for the specified public property whose parameters match the specified argument 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);
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 String String String

取得するパブリック プロパティの名前を格納している文字列。The string containing the name of the public property to get.

returnType
Type Type Type Type

プロパティの戻り値の型。The return type of the property.

types
Type[]

取得するインデックス付きプロパティに対するパラメーターの数値、順序、および型を表す Type オブジェクトの配列。An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

または-or- インデックス付けされていないプロパティを取得するための、Type 型の空の配列 (Type[] types = new Type[0])。An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

戻り値

指定した引数型と一致するパラメーターが設定されているパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は nullAn object representing the public property whose parameters match the specified argument types, if found; otherwise, null.

実装

例外

指定した名前を持ち引数の型が一致する複数のプロパティが存在します。More than one property is found with the specified name and matching the specified argument types.

namenullです。name is null.

または-or- typesnullです。types is null.

types が多次元です。types is multidimensional.

types の要素は null です。An element of types is null.

注釈

プロパティは公開されている少なくとも 1 つのアクセサーがある場合、リフレクションには、パブリックと見なされます。A property is considered public to reflection if it has at least one accessor that is public. それ以外の場合、プロパティは、プライベートと見なされ、使用する必要がありますBindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual basic での結合を使用して値Or) を取得します。Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

検索name小文字が区別されます。The search for name is case-sensitive. 検索には、パブリック static および public インスタンスのプロパティが含まれています。The search includes public static and public instance properties.

場合、現在Typeこのメソッドが戻る構築されたジェネリック型を表す、PropertyInfo適切な型引数に置き換え、型パラメーター。If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

場合、現在Type型パラメーターを表すジェネリック型またはジェネリック メソッドの定義では、このメソッドは、クラス制約のプロパティを検索します。If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

インデクサーと既定のプロパティIndexers and Default Properties

Visual Basic 2005Visual Basic 2005Visual C# 2005Visual C# 2005、およびVisual C++ 2005Visual C++ 2005インデックス付きプロパティにアクセスするための構文が簡素化され、その型の既定値にする 1 つのインデックス付きプロパティを許可します。, Visual C# 2005Visual C# 2005, and Visual C++ 2005Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. たとえば場合、変数myListを指す、 ArrayList、構文myList[3](myList(3) Visual Basic で) 3 のインデックスを持つ要素を取得します。For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. プロパティをオーバー ロードすることができます。You can overload the property.

C#、この機能は、インデクサーは呼び出され、名前によって参照することはできません。In C#, this feature is called an indexer and cannot be referred to by name. 既定では、c# インデクサーが"Item"という名前のインデックス付きプロパティとしてメタデータに表示されます。By default, a C# indexer appears in metadata as an indexed property named "Item". ただし、クラス ライブラリの開発者が使用できます、IndexerNameAttributeメタデータでインデクサーの名前を変更する属性。However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. たとえば、Stringクラスという名前のインデクサーには、Chars[Range]します。For example, the String class has an indexer named Chars[Range]. C# 以外の言語を使用して作成されたインデックス付きプロパティには、項目、以外の名前もことができます。Indexed properties created using languages other than C# can have names other than Item, as well.

型が既定のプロパティを持つかどうかを調べるには、GetCustomAttributes(Type, Boolean)メソッドをテストするため、DefaultMemberAttribute属性。To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. 型がDefaultMemberAttributeMemberNameプロパティが既定のプロパティの名前を返します。If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

こちらもご覧ください

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

指定したパブリック プロパティのうち、指定した引数の型および修飾子と一致するパラメーターが設定されているものを検索します。Searches for the specified public property whose parameters match the specified argument types and 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);
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 String String String

取得するパブリック プロパティの名前を格納している文字列。The string containing the name of the public property to get.

returnType
Type Type Type Type

プロパティの戻り値の型。The return type of the property.

types
Type[]

取得するインデックス付きプロパティに対するパラメーターの数値、順序、および型を表す Type オブジェクトの配列。An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

または-or- インデックス付けされていないプロパティを取得するための、Type 型の空の配列 (Type[] types = new Type[0])。An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

modifiers
ParameterModifier[]

types 配列内の対応する要素に関連付けられている属性を表す ParameterModifier オブジェクトの配列。An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types array. 既定のバインダーでは、このパラメーターは処理されません。The default binder does not process this parameter.

戻り値

指定した要件と一致するパブリック プロパティが存在する場合は、そのパブリック プロパティを表すオブジェクト。それ以外の場合は nullAn object representing the public property that matches the specified requirements, if found; otherwise, null.

実装

例外

指定された名前を持ち、指定された引数の型および修飾子に一致する 2 つ以上のプロパティが存在します。More than one property is found with the specified name and matching the specified argument types and modifiers.

namenullです。name is null.

- または --or- typesnullです。types is null.

types が多次元です。types is multidimensional.

または-or- modifiers が多次元です。modifiers is multidimensional.

または-or- typesmodifiers の長さが同じではありません。types and modifiers do not have the same length.

types の要素は null です。An element of types is null.

次の例では、取得、Typeオブジェクトに対応するMyPropertyClassに渡される引数を使用して、このクラスのインデックス付きプロパティを取得し、GetPropertyメソッド。The following example obtains a Type object corresponding to MyPropertyClass, and the indexed property of this class is retrieved using the arguments passed to the GetProperty method.

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
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 'MyPropertyClass

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 'Main
End Class 'MyTypeClass

注釈

プロパティは公開されている少なくとも 1 つのアクセサーがある場合、リフレクションには、パブリックと見なされます。A property is considered public to reflection if it has at least one accessor that is public. それ以外の場合、プロパティは、プライベートと見なされ、使用する必要がありますBindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual basic での結合を使用して値Or) を取得します。Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

既定のバインダーでは処理されませんがParameterModifier(、modifiersパラメーター)、抽象を使用するSystem.Reflection.Binderカスタム バインダーでは処理を書き込むクラスmodifiersします。Although the default binder does not process ParameterModifier (the modifiers parameter), you can use the abstract System.Reflection.Binder class to write a custom binder that does process modifiers. ParameterModifier COM 相互運用機能経由で呼び出す場合にのみ使用され、参照によって渡されるパラメーターのみを処理します。ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.

検索name小文字が区別されます。The search for name is case-sensitive. 検索には、パブリック static および public インスタンスのプロパティが含まれています。The search includes public static and public instance properties.

場合、現在Typeこのメソッドが戻る構築されたジェネリック型を表す、PropertyInfo適切な型引数に置き換え、型パラメーター。If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

場合、現在Type型パラメーターを表すジェネリック型またはジェネリック メソッドの定義では、このメソッドは、クラス制約のプロパティを検索します。If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

インデクサーと既定のプロパティIndexers and Default Properties

Visual Basic 2005Visual Basic 2005Visual C# 2005Visual C# 2005、およびVisual C++ 2005Visual C++ 2005インデックス付きプロパティにアクセスするための構文が簡素化され、その型の既定値にする 1 つのインデックス付きプロパティを許可します。, Visual C# 2005Visual C# 2005, and Visual C++ 2005Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. たとえば場合、変数myListを指す、 ArrayList、構文myList[3](myList(3) Visual Basic で) 3 のインデックスを持つ要素を取得します。For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. プロパティをオーバー ロードすることができます。You can overload the property.

C#、この機能は、インデクサーは呼び出され、名前によって参照することはできません。In C#, this feature is called an indexer and cannot be referred to by name. 既定では、c# インデクサーが"Item"という名前のインデックス付きプロパティとしてメタデータに表示されます。By default, a C# indexer appears in metadata as an indexed property named "Item". ただし、クラス ライブラリの開発者が使用できます、IndexerNameAttributeメタデータでインデクサーの名前を変更する属性。However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. たとえば、Stringクラスという名前のインデクサーには、Chars[Range]します。For example, the String class has an indexer named Chars[Range]. C# 以外の言語を使用して作成されたインデックス付きプロパティには、項目、以外の名前もことができます。Indexed properties created using languages other than C# can have names other than Item, as well.

型が既定のプロパティを持つかどうかを調べるには、GetCustomAttributes(Type, Boolean)メソッドをテストするため、DefaultMemberAttribute属性。To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. 型がDefaultMemberAttributeMemberNameプロパティが既定のプロパティの名前を返します。If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

こちらもご覧ください

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

指定したバインディング制約を使用して、指定した引数の型および修飾子と一致するパラメーターが設定された指定のプロパティを検索します。Searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints.

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);
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

パラメーター

name
String String String String

取得するプロパティの名前を格納している文字列。The string containing the name of the property to get.

bindingAttr
BindingFlags BindingFlags BindingFlags BindingFlags

検索を実施する方法を指定する列挙値のビットごとの組み合わせ。A bitwise combination of the enumeration values that specify how the search is conducted.

または-or- null を返す場合は DefaultDefault to return null.

binder
Binder Binder Binder Binder

一連のプロパティを定義し、バインディングを有効にするオブジェクト。バインディングには、オーバーロードされたメソッドの選択、引数の型の強制変換、リフレクションによるメンバーの呼び出しなどが含まれます。An object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.

または-or- Nothing を使用する場合は、null 参照 (Visual Basic の場合は DefaultBinder)。A null reference (Nothing in Visual Basic), to use the DefaultBinder.

returnType
Type Type Type Type

プロパティの戻り値の型。The return type of the property.

types
Type[]

取得するインデックス付きプロパティに対するパラメーターの数値、順序、および型を表す Type オブジェクトの配列。An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

または-or- インデックス付けされていないプロパティを取得するための、Type 型の空の配列 (Type[] types = new Type[0])。An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

modifiers
ParameterModifier[]

types 配列内の対応する要素に関連付けられている属性を表す ParameterModifier オブジェクトの配列。An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types array. 既定のバインダーでは、このパラメーターは処理されません。The default binder does not process this parameter.

戻り値

指定した要件と一致するプロパティが存在する場合は、そのプロパティを表すオブジェクト。それ以外の場合は nullAn object representing the property that matches the specified requirements, if found; otherwise, null.

実装

例外

指定された名前を持ち、指定されたバインディング制約に一致する 1 つ以上のプロパティが存在します。More than one property is found with the specified name and matching the specified binding constraints.

namenullです。name is null.

- または --or- typesnullです。types is null.

types が多次元です。types is multidimensional.

または-or- modifiers が多次元です。modifiers is multidimensional.

または-or- typesmodifiers の長さが同じではありません。types and modifiers do not have the same length.

types の要素は null です。An element of types is null.

注釈

プロパティは公開されている少なくとも 1 つのアクセサーがある場合、リフレクションには、パブリックと見なされます。A property is considered public to reflection if it has at least one accessor that is public. それ以外の場合、プロパティは、プライベートと見なされ、使用する必要がありますBindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (Visual basic での結合を使用して値Or) を取得します。Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

既定のバインダーでは処理されませんがParameterModifier(、modifiersパラメーター)、抽象を使用するSystem.Reflection.Binderカスタム バインダーでは処理を書き込むクラスmodifiersします。Although the default binder does not process ParameterModifier (the modifiers parameter), you can use the abstract System.Reflection.Binder class to write a custom binder that does process modifiers. ParameterModifier COM 相互運用機能経由で呼び出す場合にのみ使用され、参照によって渡されるパラメーターのみを処理します。ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.

次の表は、基底クラスのメンバーがによって返される、Getメソッドの型でリフレクション時にします。The following table shows what members of a base class are returned by the Get methods when reflecting on a type.

メンバーの型Member Type スタティックStatic 非静的Non-Static
コンストラクターConstructor いいえNo いいえNo
フィールドField いいえNo はい。Yes. フィールドは、常に、名前とシグネチャによる非表示です。A field is always hide-by-name-and-signature.
eventEvent 利用不可Not applicable 共通型システムの規則は、継承は、メソッド、プロパティを実装するのと同じです。The common type system rule is that the inheritance is the same as that of the methods that implement the property. プロパティは、リフレクションは、名前とシグネチャで隠ぺいとして扱います。Reflection treats properties as hide-by-name-and-signature. 下記のメモ 2 を参照してください。See note 2 below.
メソッドMethod いいえNo はい。Yes. (仮想および非仮想) メソッドには、名前によって隠ぺいまたは名前とシグネチャによる非表示を指定できます。A method (both virtual and non-virtual) can be hide-by-name or hide-by-name-and-signature.
入れ子にされた型Nested Type いいえNo いいえNo
プロパティProperty 利用不可Not applicable 共通型システムの規則は、継承は、メソッド、プロパティを実装するのと同じです。The common type system rule is that the inheritance is the same as that of the methods that implement the property. プロパティは、リフレクションは、名前とシグネチャで隠ぺいとして扱います。Reflection treats properties as hide-by-name-and-signature. 下記のメモ 2 を参照してください。See note 2 below.
  1. 名前とシグネチャによる非表示にするは、すべてのパーツのカスタム修飾子を含む、シグネチャの戻り値の型、パラメーターの型、sentinel、アンマネージ呼び出し規約と見なします。Hide-by-name-and-signature considers all of the parts of the signature, including custom modifiers, return types, parameter types, sentinels, and unmanaged calling conventions. これは、バイナリ比較です。This is a binary comparison.

  2. リフレクション プロパティおよびイベントは、名前とシグネチャによる非表示にするは。For reflection, properties and events are hide-by-name-and-signature. 派生クラスには get アクセサーのみ、基本クラスに、get と set アクセサーの両方を持つプロパティがある場合は、派生クラスのプロパティには、基底クラスのプロパティが非表示にし、基本クラスの set アクセス操作子にアクセスすることはできません。If you have a property with both a get and a set accessor in the base class, but the derived class has only a get accessor, the derived class property hides the base class property, and you will not be able to access the setter on the base class.

  3. カスタム属性は、共通型システムの一部ではありません。Custom attributes are not part of the common type system.

BindingFlagsフィルター フラグは、検索に含めるプロパティを定義するために使用できます。The following BindingFlags filter flags can be used to define which properties to include in the search:

  • いずれかを指定する必要がありますBindingFlags.InstanceまたはBindingFlags.Static戻り値を取得するためにします。You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.

  • 指定BindingFlags.Public検索にパブリック プロパティを含めます。Specify BindingFlags.Public to include public properties in the search.

  • 指定BindingFlags.NonPublic検索に非パブリック プロパティ (つまり、プライベート、内部、および保護されているプロパティ) を含めます。Specify BindingFlags.NonPublic to include non-public properties (that is, private, internal, and protected properties) in the search.

  • 指定BindingFlags.FlattenHierarchyに含めるpublicprotected階層; の静的メンバーprivate継承クラスの静的メンバーは含まれません。Specify BindingFlags.FlattenHierarchy to include public and protected static members up the hierarchy; private static members in inherited classes are not included.

BindingFlags修飾フラグは、検索の動作を変更するために使用できます。The following BindingFlags modifier flags can be used to change how the search works:

  • BindingFlags.IgnoreCase 大文字と小文字を無視するnameします。BindingFlags.IgnoreCase to ignore the case of name.

  • BindingFlags.DeclaredOnly 宣言されたプロパティのみを検索する、 Type、単に継承されたプロパティではなく。BindingFlags.DeclaredOnly to search only the properties declared on the Type, not properties that were simply inherited.

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

場合、現在Typeこのメソッドが戻る構築されたジェネリック型を表す、PropertyInfo適切な型引数に置き換え、型パラメーター。If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

場合、現在Type型パラメーターを表すジェネリック型またはジェネリック メソッドの定義では、このメソッドは、クラス制約のプロパティを検索します。If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

インデクサーと既定のプロパティIndexers and Default Properties

Visual Basic 2005Visual Basic 2005Visual C# 2005Visual C# 2005、およびVisual C++ 2005Visual C++ 2005インデックス付きプロパティにアクセスするための構文が簡素化され、その型の既定値にする 1 つのインデックス付きプロパティを許可します。, Visual C# 2005Visual C# 2005, and Visual C++ 2005Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. たとえば場合、変数myListを指す、 ArrayList、構文myList[3](myList(3) Visual Basic で) 3 のインデックスを持つ要素を取得します。For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. プロパティをオーバー ロードすることができます。You can overload the property.

C#、この機能は、インデクサーは呼び出され、名前によって参照することはできません。In C#, this feature is called an indexer and cannot be referred to by name. 既定では、c# インデクサーが"Item"という名前のインデックス付きプロパティとしてメタデータに表示されます。By default, a C# indexer appears in metadata as an indexed property named "Item". ただし、クラス ライブラリの開発者が使用できます、IndexerNameAttributeメタデータでインデクサーの名前を変更する属性。However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. たとえば、Stringクラスという名前のインデクサーには、Chars[Range]します。For example, the String class has an indexer named Chars[Range]. C# 以外の言語を使用して作成されたインデックス付きプロパティには、項目、以外の名前もことができます。Indexed properties created using languages other than C# can have names other than Item, as well.

型が既定のプロパティを持つかどうかを調べるには、GetCustomAttributes(Type, Boolean)メソッドをテストするため、DefaultMemberAttribute属性。To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. 型がDefaultMemberAttributeMemberNameプロパティが既定のプロパティの名前を返します。If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

こちらもご覧ください

適用対象