Type.GetProperty Метод

Определение

Получает указанное свойство текущего класса Type.

Перегрузки

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

Ищет свойство с параметрами, соответствующими указанным модификаторам и типам аргументов, с учетом заданных ограничений привязки.

GetProperty(String)

Выполняет поиск открытого свойства с заданным именем.

GetProperty(String, BindingFlags)

Ищет указанное свойство, используя заданные ограничения привязки.

GetProperty(String, Type)

Выполняет поиск открытого свойства с заданным именем и типом возвращаемого значения.

GetProperty(String, Type[])

Ищет указанное открытое свойство, параметры которого соответствуют указанным типам аргументов.

GetProperty(String, Type, Type[])

Ищет указанное открытое свойство, параметры которого соответствуют указанным типам аргументов.

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

Ищет заданное открытое свойство, параметры которого соответствуют указанным типам аргументов и модификаторам.

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

Ищет свойство с параметрами, соответствующими указанным модификаторам и типам аргументов, с учетом заданных ограничений привязки.

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

Параметры

name
String

Строка, содержащий имя искомого свойства.

bindingAttr
BindingFlags

Побитовое сочетание значений перечисления, указывающих способ проведения поиска.

-или- Default для возврата null.

binder
Binder

Объект, определяющий набор свойств и разрешающий привязку, что может включать выбор перегруженных методов, приведение типов аргументов и вызов члена с помощью отражения.

-или- Пустая ссылка (Nothing в Visual Basic) для использования свойства DefaultBinder.

returnType
Type

Возвращаемый тип свойства.

types
Type[]

Массив объектов Type , предоставляющий число, порядок и тип параметров искомого индексированного свойства.

-или- Пустой массив объектов типа Type (то есть Type[] types = new Type[0]), если требуется получить неиндексированное свойство.

modifiers
ParameterModifier[]

Массив объектов ParameterModifier, представляющих атрибуты, связанные с соответствующим элементом в массиве types. Связыватель по умолчанию не обрабатывает этот параметр.

Возвращаемое значение

PropertyInfo

Объект, предоставляющий свойство, которое соответствует указанным требованиям, если такое свойство найдено; в противном случае возвращается null.

Реализации

Исключения

Найдено несколько свойств с указанным именем и соответствующих указанным ограничениям привязки.

name имеет значение null.

-или- types имеет значение null.

Массив types является многомерным.

-или- Массив modifiers является многомерным.

-или- types и modifiers имеют разную длину.

Элемент types имеет значение null.

Комментарии

Свойство считается открытым для отражения, если у него есть по крайней мере один открытый метод доступа. в противном случае свойство считается закрытым и необходимо использовать BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (в Visual Basic объединить значения с помощью Or ), чтобы получить его.

Хотя связыватель по умолчанию не обрабатывается ParameterModifier ( modifiers параметр), можно использовать абстрактный System.Reflection.Binder класс для написания пользовательского связывателя, который обрабатывает modifiers . ParameterModifier используется только при вызове через COM-взаимодействие, и обрабатываются только параметры, передаваемые по ссылке.

В следующей таблице показано, какие члены базового класса возвращаются Get методами при отражении в типе.

Тип члена Статические Не статический
Конструктор Нет Нет
Поле Нет Да. Поле всегда скрывается по имени и сигнатуре.
Событие Неприменимо Правило системы общих типов — это то же наследование, что и методы, реализующие свойство. Отражение рассматривает свойства как скрытые по имени и сигнатуре. См. Примечание 2 ниже.
Метод Нет Да. Метод (как виртуальный, так и невиртуальный) может быть скрыт по имени или скрытию по имени и сигнатуре.
Вложенный тип Нет Нет
Свойство. Неприменимо Правило системы общих типов — это то же наследование, что и методы, реализующие свойство. Отражение рассматривает свойства как скрытые по имени и сигнатуре. См. Примечание 2 ниже.
  1. При скрытии по имени и сигнатуре учитываются все части сигнатуры, включая пользовательские модификаторы, возвращаемые типы, типы параметров, Sentinel и неуправляемые соглашения о вызовах. Это двоичное сравнение.

  2. Для отражения свойства и события скрываются по имени и сигнатуре. Если у вас есть свойство с методом доступа get и Set в базовом классе, но производный класс имеет только метод доступа get, свойство производного класса скрывает свойство базового класса, и вы не сможете получить доступ к методу задания в базовом классе.

  3. Настраиваемые атрибуты не являются частью системы общих типов.

BindingFlagsДля определения свойств, включаемых в поиск, можно использовать следующие флаги фильтра:

  • Необходимо указать или, BindingFlags.Instance BindingFlags.Static чтобы получить возвращаемое значение.

  • Укажите BindingFlags.Public , чтобы включить в поиск открытые свойства.

  • Укажите, BindingFlags.NonPublic чтобы включить в поиск не являющиеся общими свойства (т. е. частные, внутренние и защищенные).

  • Укажите, BindingFlags.FlattenHierarchy следует public ли включать и protected статические элементы вверх по иерархии; private статические члены в наследуемых классах не включаются.

BindingFlagsДля изменения работы поиска можно использовать следующие флаги модификаторов:

  • BindingFlags.IgnoreCase значение, чтобы игнорировать регистр name .

  • BindingFlags.DeclaredOnly значение, чтобы искать только свойства, объявленные в Type , а не свойства, которые были просто унаследованы.

Дополнительные сведения см. в разделе System.Reflection.BindingFlags.

Если текущий объект Type представляет сконструированный универсальный тип, этот метод возвращает объект PropertyInfo с параметрами типа, замененными соответствующими аргументами типа.

Если Current Type представляет параметр типа в определении универсального типа или универсального метода, этот метод выполняет поиск в свойствах ограничения класса.

Индексаторы и свойства по умолчанию

Visual Basic 2005, Visual C# 2005 и Visual C++ 2005 имеют упрощенный синтаксис для доступа к индексированным свойствам и позволяют одному индексированному свойству быть значение по умолчанию для его типа. например, если переменная myList ссылается на ArrayList , синтаксис myList[3] ( myList(3) в Visual Basic) извлекает элемент с индексом 3. Можно перегрузить свойство.

В C# эта функция называется индексатором, и на нее нельзя ссылаться по имени. По умолчанию индексатор C# отображается в метаданных как индексированное свойство с именем Item. Однако разработчик библиотеки классов может использовать IndexerNameAttribute атрибут для изменения имени индексатора в метаданных. Например, у String класса есть индексатор с именем Chars[] . Индексированные свойства, созданные с помощью языков, отличных от C#, также могут иметь имена, отличные от Item.

Чтобы определить, имеет ли тип свойство по умолчанию, используйте GetCustomAttributes(Type, Boolean) метод для проверки DefaultMemberAttribute атрибута. Если тип имеет значение DefaultMemberAttribute , MemberName свойство возвращает имя свойства по умолчанию.

См. также раздел

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

GetProperty(String)

Выполняет поиск открытого свойства с заданным именем.

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

Параметры

name
String

Строка, содержащая искомое имя открытого свойства.

Возвращаемое значение

PropertyInfo

Объект, представляющий открытое свойство с заданным именем, если такое свойство есть, и null, если такого свойства нет.

Реализации

Исключения

Найдено несколько свойств с указанным именем.

name имеет значение null.

Примеры

В следующем примере извлекается Type объект определяемого пользователем класса, извлекается свойство этого класса и отображается имя свойства.

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

public:

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

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

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

using System;
using System.Reflection;

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

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

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

На внутреннем уровне это свойство упоминается в метаданных по имени "Item". Любая попытка получить PropertyInfo использование отражения должна указывать это внутреннее имя, чтобы правильно возвращать PropertyInfo свойство.

Комментарии

nameПри поиске учитывается регистр. Поиск включает открытые статические и открытые свойства экземпляра.

Свойство считается открытым для отражения, если у него есть по крайней мере один открытый метод доступа. в противном случае свойство считается закрытым и необходимо использовать BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (в Visual Basic объединить значения с помощью Or ), чтобы получить его.

Если текущий объект Type представляет сконструированный универсальный тип, этот метод возвращает объект PropertyInfo с параметрами типа, замененными соответствующими аргументами типа.

Если Current Type представляет параметр типа в определении универсального типа или универсального метода, этот метод выполняет поиск в свойствах ограничения класса.

Возможны следующие ситуации, в которых AmbiguousMatchException происходит следующее.

  • Тип содержит два индексированных свойства с одинаковыми именами, но разными числами параметров. Чтобы устранить неоднозначность, используйте перегрузку GetProperty метода, который указывает типы параметров.

  • Производный тип объявляет свойство, которое скрывает унаследованное свойство с тем же именем, с помощью new модификатора ( Shadows в Visual Basic). Чтобы устранить неоднозначность, используйте GetProperty(String, BindingFlags) перегрузку метода и добавьте BindingFlags.DeclaredOnly флаг, чтобы ограничить поиск неунаследованными членами.

Индексаторы и свойства по умолчанию

Visual Basic 2005, Visual C# 2005 и Visual C++ 2005 имеют упрощенный синтаксис для доступа к индексированным свойствам и позволяют одному индексированному свойству быть значение по умолчанию для его типа. например, если переменная myList ссылается на ArrayList , синтаксис myList[3] ( myList(3) в Visual Basic) извлекает элемент с индексом 3. Можно перегрузить свойство.

В C# эта функция называется индексатором, и на нее нельзя ссылаться по имени. По умолчанию индексатор C# отображается в метаданных как индексированное свойство с именем Item. Однако разработчик библиотеки классов может использовать IndexerNameAttribute атрибут для изменения имени индексатора в метаданных. Например, у String класса есть индексатор с именем Chars[] . Индексированные свойства, созданные с помощью языков, отличных от C#, также могут иметь имена, отличные от Item.

Чтобы определить, имеет ли тип свойство по умолчанию, используйте GetCustomAttributes(Type, Boolean) метод для проверки DefaultMemberAttribute атрибута. Если тип имеет значение DefaultMemberAttribute , MemberName свойство возвращает имя свойства по умолчанию.

См. также раздел

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

GetProperty(String, BindingFlags)

Ищет указанное свойство, используя заданные ограничения привязки.

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

Параметры

name
String

Строка, содержащий имя искомого свойства.

bindingAttr
BindingFlags

Побитовое сочетание значений перечисления, указывающих способ проведения поиска.

-или- Default для возврата null.

Возвращаемое значение

PropertyInfo

Объект, предоставляющий свойство, которое соответствует указанным требованиям, если такое свойство найдено; в противном случае возвращается null.

Реализации

Исключения

Найдено несколько свойств с указанным именем и соответствующих указанным ограничениям привязки.

name имеет значение null.

Примеры

В следующем примере извлекается тип определяемого пользователем класса, извлекается свойство этого класса и отображается имя свойства в соответствии с заданными ограничениями привязки.

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

public:

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

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

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

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

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

Комментарии

Свойство считается открытым для отражения, если у него есть по крайней мере один открытый метод доступа. в противном случае свойство считается закрытым и необходимо использовать BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (в Visual Basic объединить значения с помощью Or ), чтобы получить его.

BindingFlagsДля определения свойств, включаемых в поиск, можно использовать следующие флаги фильтра:

  • Необходимо указать или, BindingFlags.Instance BindingFlags.Static чтобы получить возвращаемое значение.

  • Укажите BindingFlags.Public , чтобы включить в поиск открытые свойства.

  • Укажите, BindingFlags.NonPublic чтобы включить в поиск не являющиеся общими свойства (т. е. частные, внутренние и защищенные).

  • Укажите, BindingFlags.FlattenHierarchy следует public ли включать и protected статические элементы вверх по иерархии; private статические члены в наследуемых классах не включаются.

BindingFlagsДля изменения работы поиска можно использовать следующие флаги модификаторов:

  • BindingFlags.IgnoreCase значение, чтобы игнорировать регистр name .

  • BindingFlags.DeclaredOnly значение, чтобы искать только свойства, объявленные в Type , а не свойства, которые были просто унаследованы.

Дополнительные сведения см. в разделе System.Reflection.BindingFlags.

Если текущий объект Type представляет сконструированный универсальный тип, этот метод возвращает объект PropertyInfo с параметрами типа, замененными соответствующими аргументами типа.

Если Current Type представляет параметр типа в определении универсального типа или универсального метода, этот метод выполняет поиск в свойствах ограничения класса.

Возможны следующие ситуации, в которых AmbiguousMatchException происходит следующее.

  • Тип содержит два индексированных свойства с одинаковыми именами, но разными числами параметров. Чтобы устранить неоднозначность, используйте перегрузку GetProperty метода, который указывает типы параметров.

  • Производный тип объявляет свойство, которое скрывает унаследованное свойство с тем же именем, с помощью new модификатора ( Shadows в Visual Basic). Чтобы устранить неоднозначность, включите, BindingFlags.DeclaredOnly чтобы ограничить поиск неунаследованными членами.

Индексаторы и свойства по умолчанию

Visual Basic 2005, Visual C# 2005 и Visual C++ 2005 имеют упрощенный синтаксис для доступа к индексированным свойствам и позволяют одному индексированному свойству быть значение по умолчанию для его типа. например, если переменная myList ссылается на ArrayList , синтаксис myList[3] ( myList(3) в Visual Basic) извлекает элемент с индексом 3. Можно перегрузить свойство.

В C# эта функция называется индексатором, и на нее нельзя ссылаться по имени. По умолчанию индексатор C# отображается в метаданных как индексированное свойство с именем Item. Однако разработчик библиотеки классов может использовать IndexerNameAttribute атрибут для изменения имени индексатора в метаданных. Например, у String класса есть индексатор с именем Chars[] . Индексированные свойства, созданные с помощью языков, отличных от C#, также могут иметь имена, отличные от Item.

Чтобы определить, имеет ли тип свойство по умолчанию, используйте GetCustomAttributes(Type, Boolean) метод для проверки DefaultMemberAttribute атрибута. Если тип имеет значение DefaultMemberAttribute , MemberName свойство возвращает имя свойства по умолчанию.

См. также раздел

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

GetProperty(String, Type)

Выполняет поиск открытого свойства с заданным именем и типом возвращаемого значения.

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

Параметры

name
String

Строка, содержащая искомое имя открытого свойства.

returnType
Type

Возвращаемый тип свойства.

Возвращаемое значение

PropertyInfo

Объект, представляющий открытое свойство с заданным именем, если такое свойство есть, и null, если такого свойства нет.

Реализации

Исключения

Найдено несколько свойств с указанным именем.

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

Примеры

В следующем примере определяется класс с одним свойством и извлекается имя и тип свойства.

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

public:

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

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

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

}

using System;
using System.Reflection;

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

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

    End Sub
End Class

Комментарии

Свойство считается открытым для отражения, если у него есть по крайней мере один открытый метод доступа. в противном случае свойство считается закрытым и необходимо использовать BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (в Visual Basic объединить значения с помощью Or ), чтобы получить его.

nameПри поиске учитывается регистр. Поиск включает открытые статические и открытые свойства экземпляра.

Если текущий объект Type представляет сконструированный универсальный тип, этот метод возвращает объект PropertyInfo с параметрами типа, замененными соответствующими аргументами типа.

Если Current Type представляет параметр типа в определении универсального типа или универсального метода, этот метод выполняет поиск в свойствах ограничения класса.

Индексаторы и свойства по умолчанию

Visual Basic 2005, Visual C# 2005 и Visual C++ 2005 имеют упрощенный синтаксис для доступа к индексированным свойствам и позволяют одному индексированному свойству быть значение по умолчанию для его типа. например, если переменная myList ссылается на ArrayList , синтаксис myList[3] ( myList(3) в Visual Basic) извлекает элемент с индексом 3. Можно перегрузить свойство.

В C# эта функция называется индексатором, и на нее нельзя ссылаться по имени. По умолчанию индексатор C# отображается в метаданных как индексированное свойство с именем Item. Однако разработчик библиотеки классов может использовать IndexerNameAttribute атрибут для изменения имени индексатора в метаданных. Например, у String класса есть индексатор с именем Chars[] . Индексированные свойства, созданные с помощью языков, отличных от C#, также могут иметь имена, отличные от Item.

Чтобы определить, имеет ли тип свойство по умолчанию, используйте GetCustomAttributes(Type, Boolean) метод для проверки DefaultMemberAttribute атрибута. Если тип имеет значение DefaultMemberAttribute , MemberName свойство возвращает имя свойства по умолчанию.

См. также раздел

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

GetProperty(String, Type[])

Ищет указанное открытое свойство, параметры которого соответствуют указанным типам аргументов.

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

Параметры

name
String

Строка, содержащая искомое имя открытого свойства.

types
Type[]

Массив объектов Type, предоставляющий число, порядок и тип параметров искомого индексированного свойства.

-или- Пустой массив объектов типа Type (то есть Type[] types = new Type[0]), если требуется получить неиндексированное свойство.

Возвращаемое значение

PropertyInfo

Объект, представляющий открытое свойство, параметры которого соответствуют указанным типам аргументов, если таковые найдены; в противном случае — null.

Реализации

Исключения

Найдено несколько свойств с указанным именем и соответствующих указанным типам аргументов.

name имеет значение null.

-или- types имеет значение null.

Массив types является многомерным.

Элемент types имеет значение null.

Примеры

В следующем примере извлекается Type объект определяемого пользователем класса, извлекается свойство этого класса и отображается имя свойства и его тип, как указано аргументами, передаваемыми в GetProperty .

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

public:

   property int Item [int, int]
   {

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

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

   }

};

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

}

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

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

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

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

Комментарии

Свойство считается открытым для отражения, если у него есть по крайней мере один открытый метод доступа. в противном случае свойство считается закрытым и необходимо использовать BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (в Visual Basic объединить значения с помощью Or ), чтобы получить его.

nameПри поиске учитывается регистр. Поиск включает открытые статические и открытые свойства экземпляра.

Если текущий объект Type представляет сконструированный универсальный тип, этот метод возвращает объект PropertyInfo с параметрами типа, замененными соответствующими аргументами типа.

Если Current Type представляет параметр типа в определении универсального типа или универсального метода, этот метод выполняет поиск в свойствах ограничения класса.

Индексаторы и свойства по умолчанию

Visual Basic 2005, Visual C# 2005 и Visual C++ 2005 имеют упрощенный синтаксис для доступа к индексированным свойствам и позволяют одному индексированному свойству быть значение по умолчанию для его типа. например, если переменная myList ссылается на ArrayList , синтаксис myList[3] ( myList(3) в Visual Basic) извлекает элемент с индексом 3. Можно перегрузить свойство.

В C# эта функция называется индексатором, и на нее нельзя ссылаться по имени. По умолчанию индексатор C# отображается в метаданных как индексированное свойство с именем Item. Однако разработчик библиотеки классов может использовать IndexerNameAttribute атрибут для изменения имени индексатора в метаданных. Например, у String класса есть индексатор с именем Chars[] . Индексированные свойства, созданные с помощью языков, отличных от C#, также могут иметь имена, отличные от Item.

Чтобы определить, имеет ли тип свойство по умолчанию, используйте GetCustomAttributes(Type, Boolean) метод для проверки DefaultMemberAttribute атрибута. Если тип имеет значение DefaultMemberAttribute , MemberName свойство возвращает имя свойства по умолчанию.

См. также раздел

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

GetProperty(String, Type, Type[])

Ищет указанное открытое свойство, параметры которого соответствуют указанным типам аргументов.

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

Параметры

name
String

Строка, содержащая искомое имя открытого свойства.

returnType
Type

Возвращаемый тип свойства.

types
Type[]

Массив объектов Type , предоставляющий число, порядок и тип параметров искомого индексированного свойства.

-или- Пустой массив объектов типа Type (то есть Type[] types = new Type[0]), если требуется получить неиндексированное свойство.

Возвращаемое значение

PropertyInfo

Объект, представляющий открытое свойство, параметры которого соответствуют указанным типам аргументов, если таковые найдены; в противном случае — null.

Реализации

Исключения

Найдено несколько свойств с указанным именем и соответствующих указанным типам аргументов.

name имеет значение null.

-или- types имеет значение null.

Массив types является многомерным.

Элемент types имеет значение null.

Комментарии

Свойство считается открытым для отражения, если у него есть по крайней мере один открытый метод доступа. в противном случае свойство считается закрытым и необходимо использовать BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (в Visual Basic объединить значения с помощью Or ), чтобы получить его.

nameПри поиске учитывается регистр. Поиск включает открытые статические и открытые свойства экземпляра.

Если текущий объект Type представляет сконструированный универсальный тип, этот метод возвращает объект PropertyInfo с параметрами типа, замененными соответствующими аргументами типа.

Если Current Type представляет параметр типа в определении универсального типа или универсального метода, этот метод выполняет поиск в свойствах ограничения класса.

Индексаторы и свойства по умолчанию

Visual Basic 2005, Visual C# 2005 и Visual C++ 2005 имеют упрощенный синтаксис для доступа к индексированным свойствам и позволяют одному индексированному свойству быть значение по умолчанию для его типа. например, если переменная myList ссылается на ArrayList , синтаксис myList[3] ( myList(3) в Visual Basic) извлекает элемент с индексом 3. Можно перегрузить свойство.

В C# эта функция называется индексатором, и на нее нельзя ссылаться по имени. По умолчанию индексатор C# отображается в метаданных как индексированное свойство с именем Item. Однако разработчик библиотеки классов может использовать IndexerNameAttribute атрибут для изменения имени индексатора в метаданных. Например, у String класса есть индексатор с именем Chars[] . Индексированные свойства, созданные с помощью языков, отличных от C#, также могут иметь имена, отличные от Item.

Чтобы определить, имеет ли тип свойство по умолчанию, используйте GetCustomAttributes(Type, Boolean) метод для проверки DefaultMemberAttribute атрибута. Если тип имеет значение DefaultMemberAttribute , MemberName свойство возвращает имя свойства по умолчанию.

См. также раздел

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

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

Ищет заданное открытое свойство, параметры которого соответствуют указанным типам аргументов и модификаторам.

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

Параметры

name
String

Строка, содержащая искомое имя открытого свойства.

returnType
Type

Возвращаемый тип свойства.

types
Type[]

Массив объектов Type , предоставляющий число, порядок и тип параметров искомого индексированного свойства.

-или- Пустой массив объектов типа Type (то есть Type[] types = new Type[0]), если требуется получить неиндексированное свойство.

modifiers
ParameterModifier[]

Массив объектов ParameterModifier, представляющих атрибуты, связанные с соответствующим элементом в массиве types. Связыватель по умолчанию не обрабатывает этот параметр.

Возвращаемое значение

PropertyInfo

Объект, представляющий открытое свойство, которое соответствует указанным требованиям, если такое свойство найдено; в противном случае возвращается null.

Реализации

Исключения

Найдено несколько свойств с указанным именем и соответствующих указанным типам аргументов и модификаторам.

name имеет значение null.

-или- types имеет значение null.

Массив types является многомерным.

-или- Массив modifiers является многомерным.

-или- types и modifiers имеют разную длину.

Элемент types имеет значение null.

Примеры

В следующем примере получается Type объект MyPropertyClass , соответствующий, а индексированное свойство этого класса извлекается с помощью аргументов, переданных в GetProperty метод.

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

public:

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

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

   }

};

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

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

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

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

Комментарии

Свойство считается открытым для отражения, если у него есть по крайней мере один открытый метод доступа. в противном случае свойство считается закрытым и необходимо использовать BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (в Visual Basic объединить значения с помощью Or ), чтобы получить его.

Хотя связыватель по умолчанию не обрабатывается ParameterModifier ( modifiers параметр), можно использовать абстрактный System.Reflection.Binder класс для написания пользовательского связывателя, который обрабатывает modifiers . ParameterModifier используется только при вызове через COM-взаимодействие, и обрабатываются только параметры, передаваемые по ссылке.

nameПри поиске учитывается регистр. Поиск включает открытые статические и открытые свойства экземпляра.

Если текущий объект Type представляет сконструированный универсальный тип, этот метод возвращает объект PropertyInfo с параметрами типа, замененными соответствующими аргументами типа.

Если Current Type представляет параметр типа в определении универсального типа или универсального метода, этот метод выполняет поиск в свойствах ограничения класса.

Индексаторы и свойства по умолчанию

Visual Basic 2005, Visual C# 2005 и Visual C++ 2005 имеют упрощенный синтаксис для доступа к индексированным свойствам и позволяют одному индексированному свойству быть значение по умолчанию для его типа. например, если переменная myList ссылается на ArrayList , синтаксис myList[3] ( myList(3) в Visual Basic) извлекает элемент с индексом 3. Можно перегрузить свойство.

В C# эта функция называется индексатором, и на нее нельзя ссылаться по имени. По умолчанию индексатор C# отображается в метаданных как индексированное свойство с именем Item. Однако разработчик библиотеки классов может использовать IndexerNameAttribute атрибут для изменения имени индексатора в метаданных. Например, у String класса есть индексатор с именем Chars[] . Индексированные свойства, созданные с помощью языков, отличных от C#, также могут иметь имена, отличные от Item.

Чтобы определить, имеет ли тип свойство по умолчанию, используйте GetCustomAttributes(Type, Boolean) метод для проверки DefaultMemberAttribute атрибута. Если тип имеет значение DefaultMemberAttribute , MemberName свойство возвращает имя свойства по умолчанию.

См. также раздел

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