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.

Возвраты

Объект, представляющий открытое свойство с заданным именем, если такое свойство есть, и null, если такого свойства нет.An 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. Поиск включает общедоступный статический и открытый экземпляр свойства.The search includes public static and public instance properties.

Если у него есть хотя бы один открытый метод доступа, свойство считается открытым для отражения.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:

  • Тип содержит два индексированные свойства, которые имеют одинаковое имя, но различное число параметров.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 2005, Visual C# 2005Visual C# 2005, и Visual C++ 2005Visual C++ 2005 упрощенный синтаксис для доступа к индексированным свойствам и разрешить одно индексированное свойство по умолчанию для его типа., 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. Если тип имеет DefaultMemberAttribute, MemberName свойство возвращает имя свойства по умолчанию.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- Default для возврата null.Default to return null.

Возвраты

Объект, предоставляющий свойство, которое соответствует указанным требованиям, если такое свойство найдено; в противном случае возвращается null.An object representing the property that matches the specified requirements, if found; otherwise, null.

Реализации

Исключения

Найдено несколько свойств с указанным именем и соответствующих указанным ограничениям привязки.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

Комментарии

Если у него есть хотя бы один открытый метод доступа, свойство считается открытым для отражения.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 для включения public и protected статические члены вверху иерархии; 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:

  • Тип содержит два индексированные свойства, которые имеют одинаковое имя, но различное число параметров.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 2005, Visual C# 2005Visual C# 2005, и Visual C++ 2005Visual C++ 2005 упрощенный синтаксис для доступа к индексированным свойствам и разрешить одно индексированное свойство по умолчанию для его типа., 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. Если тип имеет DefaultMemberAttribute, MemberName свойство возвращает имя свойства по умолчанию.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.

Возвраты

Объект, представляющий открытое свойство с заданным именем, если такое свойство есть, и null, если такого свойства нет.An object representing the public property with the specified name, if found; otherwise, null.

Реализации

Исключения

Найдено несколько свойств с указанным именем.More than one property is found with the specified name.

name имеет значение null, или returnType имеет значение null.name is null, or returnType is null.

Примеры

В следующем примере определяется класс с одним свойством и возвращает имя и тип свойства.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

Комментарии

Если у него есть хотя бы один открытый метод доступа, свойство считается открытым для отражения.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. Поиск включает общедоступный статический и открытый экземпляр свойства.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 2005, Visual C# 2005Visual C# 2005, и Visual C++ 2005Visual C++ 2005 упрощенный синтаксис для доступа к индексированным свойствам и разрешить одно индексированное свойство по умолчанию для его типа., 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. Если тип имеет DefaultMemberAttribute, MemberName свойство возвращает имя свойства по умолчанию.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.

Возвраты

Объект, представляющий открытое свойство, параметры которого соответствуют указанным типам аргументов, если таковые найдены; в противном случае — null.An 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

Комментарии

Если у него есть хотя бы один открытый метод доступа, свойство считается открытым для отражения.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. Поиск включает общедоступный статический и открытый экземпляр свойства.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 2005, Visual C# 2005Visual C# 2005, и Visual C++ 2005Visual C++ 2005 упрощенный синтаксис для доступа к индексированным свойствам и разрешить одно индексированное свойство по умолчанию для его типа., 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. Если тип имеет DefaultMemberAttribute, MemberName свойство возвращает имя свойства по умолчанию.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.

Возвраты

Объект, представляющий открытое свойство, параметры которого соответствуют указанным типам аргументов, если таковые найдены; в противном случае — null.An 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.

Комментарии

Если у него есть хотя бы один открытый метод доступа, свойство считается открытым для отражения.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. Поиск включает общедоступный статический и открытый экземпляр свойства.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 2005, Visual C# 2005Visual C# 2005, и Visual C++ 2005Visual C++ 2005 упрощенный синтаксис для доступа к индексированным свойствам и разрешить одно индексированное свойство по умолчанию для его типа., 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. Если тип имеет DefaultMemberAttribute, MemberName свойство возвращает имя свойства по умолчанию.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[]

Массив объектов ParameterModifier, представляющих атрибуты, связанные с соответствующим элементом в массиве types.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.

Возвраты

Объект, представляющий открытое свойство, которое соответствует указанным требованиям, если такое свойство найдено; в противном случае возвращается null.An object representing the public property that matches the specified requirements, if found; otherwise, null.

Реализации

Исключения

Найдено несколько свойств с указанным именем и соответствующих указанным типам аргументов и модификаторам.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- types и modifiers имеют разную длину.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

Комментарии

Если у него есть хотя бы один открытый метод доступа, свойство считается открытым для отражения.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. Поиск включает общедоступный статический и открытый экземпляр свойства.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 2005, Visual C# 2005Visual C# 2005, и Visual C++ 2005Visual C++ 2005 упрощенный синтаксис для доступа к индексированным свойствам и разрешить одно индексированное свойство по умолчанию для его типа., 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. Если тип имеет DefaultMemberAttribute, MemberName свойство возвращает имя свойства по умолчанию.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- Default для возврата null.Default 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 в 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[]

Массив объектов ParameterModifier, представляющих атрибуты, связанные с соответствующим элементом в массиве types.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.

Возвраты

Объект, предоставляющий свойство, которое соответствует указанным требованиям, если такое свойство найдено; в противном случае возвращается null.An object representing the property that matches the specified requirements, if found; otherwise, null.

Реализации

Исключения

Найдено несколько свойств с указанным именем и соответствующих указанным ограничениям привязки.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- types и modifiers имеют разную длину.types and modifiers do not have the same length.

Элемент types имеет значение null.An element of types is null.

Комментарии

Если у него есть хотя бы один открытый метод доступа, свойство считается открытым для отражения.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 StaticStatic СтатическимNon-Static
КонструкторConstructor НетNo НетNo
ПолеField НетNo Да.Yes. Поле всегда равно по имени и подписи.A field is always hide-by-name-and-signature.
событиеEvent Неприменимо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. По имени и подписи считает, что все части сигнатуры, включая настраиваемые модификаторы, возвращают типы, типы параметров, меток и соглашения о неуправляемых вызовах.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 и set в базовом классе, но производный класс имеет только метод доступа get, свойство производного класса скрывает свойство базового класса, и вы не сможете получить доступ к методу 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. Настраиваемые атрибуты не являются частью система общих типов CTS.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 для включения public и protected статические члены вверху иерархии; 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 2005, Visual C# 2005Visual C# 2005, и Visual C++ 2005Visual C++ 2005 упрощенный синтаксис для доступа к индексированным свойствам и разрешить одно индексированное свойство по умолчанию для его типа., 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. Если тип имеет DefaultMemberAttribute, MemberName свойство возвращает имя свойства по умолчанию.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Дополнительно

Применяется к