PropertyInfo Класс

Определение

Пространство имен:

System.Reflection

Сборки:

netstandard.dll, System.Runtime.dll

Исходный код:

PropertyInfo.cs

Обнаруживает атрибуты свойства и предоставляет доступ к метаданным свойств.

public ref class PropertyInfo abstract : System::Reflection::MemberInfo

public abstract class PropertyInfo : System.Reflection.MemberInfo

type PropertyInfo = class
    inherit MemberInfo

Public MustInherit Class PropertyInfo
Inherits MemberInfo

Наследование

Object

MemberInfo

PropertyInfo

Производный

Microsoft.JScript.COMPropertyInfo

System.Reflection.Emit.PropertyBuilder

Примеры

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

Замечание

В этом примере создается около 55 000 строк данных, которые можно перенаправить в текстовый файл в командной строке следующим образом: example.exe propertyinfo.txt>

using System;
using System.Reflection;

class Module1
{
    public static void Main()
    {
        // This variable holds the amount of indenting that
        // should be used when displaying each line of information.
        Int32 indent = 0;
        // Display information about the EXE assembly.
        Assembly a = typeof(Module1).Assembly;
        Display(indent, "Assembly identity={0}", a.FullName);
        Display(indent+1, "Codebase={0}", a.CodeBase);

        // Display the set of assemblies our assemblies reference.

        Display(indent, "Referenced assemblies:");
        foreach (AssemblyName an in a.GetReferencedAssemblies() )
        {
             Display(indent + 1, "Name={0}, Version={1}, Culture={2}, PublicKey token={3}", an.Name, an.Version, an.CultureInfo.Name, (BitConverter.ToString (an.GetPublicKeyToken())));
        }
        Display(indent, "");

        // Display information about each assembly loading into this AppDomain.
        foreach (Assembly b in AppDomain.CurrentDomain.GetAssemblies())
        {
            Display(indent, "Assembly: {0}", b);

            // Display information about each module of this assembly.
            foreach ( Module m in b.GetModules(true) )
            {
                Display(indent+1, "Module: {0}", m.Name);
            }

            // Display information about each type exported from this assembly.

            indent += 1;
            foreach ( Type t in b.GetExportedTypes() )
            {
                Display(0, "");
                Display(indent, "Type: {0}", t);

                // For each type, show its members & their custom attributes.

                indent += 1;
                foreach (MemberInfo mi in t.GetMembers() )
                {
                    Display(indent, "Member: {0}", mi.Name);
                    DisplayAttributes(indent, mi);

                    // If the member is a method, display information about its parameters.

                    if (mi.MemberType==MemberTypes.Method)
                    {
                        foreach ( ParameterInfo pi in ((MethodInfo) mi).GetParameters() )
                        {
                            Display(indent+1, "Parameter: Type={0}, Name={1}", pi.ParameterType, pi.Name);
                        }
                    }

                    // If the member is a property, display information about the property's accessor methods.
                    if (mi.MemberType==MemberTypes.Property)
                    {
                        foreach ( MethodInfo am in ((PropertyInfo) mi).GetAccessors() )
                        {
                            Display(indent+1, "Accessor method: {0}", am);
                        }
                    }
                }
                indent -= 1;
            }
            indent -= 1;
        }
    }

    // Displays the custom attributes applied to the specified member.
    public static void DisplayAttributes(Int32 indent, MemberInfo mi)
    {
        // Get the set of custom attributes; if none exist, just return.
        object[] attrs = mi.GetCustomAttributes(false);
        if (attrs.Length==0) {return;}

        // Display the custom attributes applied to this member.
        Display(indent+1, "Attributes:");
        foreach ( object o in attrs )
        {
            Display(indent+2, "{0}", o.ToString());
        }
    }

    // Display a formatted string indented by the specified amount.
    public static void Display(Int32 indent, string format, params object[] param)

    {
        Console.Write(new string(' ', indent*2));
        Console.WriteLine(format, param);
    }
}

//The output shown below is abbreviated.
//
//Assembly identity=ReflectionCS, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null
//  Codebase=file:///C:/Documents and Settings/test/My Documents/Visual Studio 2005/Projects/Reflection/Reflection/obj/Debug/Reflection.exe
//Referenced assemblies:
//  Name=mscorlib, Version=2.0.0.0, Culture=, PublicKey token=B7-7A-5C-56-19-34-E0-89
//
//Assembly: mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//
//  Type: System.Object
//    Member: GetType
//    Member: ToString
//    Member: Equals
//      Parameter: Type=System.Object, Name=obj
//    Member: Equals
//      Parameter: Type=System.Object, Name=objA
//      Parameter: Type=System.Object, Name=objB
//    Member: ReferenceEquals
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//      Parameter: Type=System.Object, Name=objA
//      Parameter: Type=System.Object, Name=objB
//    Member: GetHashCode
//    Member: .ctor
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//
//  Type: System.ICloneable
//    Member: Clone
//
//  Type: System.Collections.IEnumerable
//    Member: GetEnumerator
//      Attributes:
//        System.Runtime.InteropServices.DispIdAttribute
//
//  Type: System.Collections.ICollection
//    Member: CopyTo
//      Parameter: Type=System.Array, Name=array
//      Parameter: Type=System.Int32, Name=index
//    Member: get_Count
//    Member: get_SyncRoot
//    Member: get_IsSynchronized
//    Member: Count
//      Accessor method: Int32 get_Count()
//    Member: SyncRoot
//      Accessor method: System.Object get_SyncRoot()
//    Member: IsSynchronized
//      Accessor method: Boolean get_IsSynchronized()
//
//  Type: System.Collections.IList
//    Member: get_Item
//      Parameter: Type=System.Int32, Name=index
//    Member: set_Item
//      Parameter: Type=System.Int32, Name=index
//      Parameter: Type=System.Object, Name=value
//    Member: Add
//      Parameter: Type=System.Object, Name=value
//    Member: Contains
//      Parameter: Type=System.Object, Name=value
//    Member: Clear
//    Member: get_IsReadOnly
//    Member: get_IsFixedSize
//    Member: IndexOf
//      Parameter: Type=System.Object, Name=value
//    Member: Insert
//      Parameter: Type=System.Int32, Name=index
//      Parameter: Type=System.Object, Name=value
//    Member: Remove
//      Parameter: Type=System.Object, Name=value
//    Member: RemoveAt
//      Parameter: Type=System.Int32, Name=index
//    Member: Item
//      Accessor method: System.Object get_Item(Int32)
//      Accessor method: Void set_Item(Int32, System.Object)
//    Member: IsReadOnly
//      Accessor method: Boolean get_IsReadOnly()
//    Member: IsFixedSize
//      Accessor method: Boolean get_IsFixedSize()
//
//  Type: System.Array
//    Member: IndexOf
//      Parameter: Type=T[], Name=array
//      Parameter: Type=T, Name=value
//    Member: AsReadOnly
//      Parameter: Type=T[], Name=array
//    Member: Resize
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//      Parameter: Type=T[]&, Name=array
//      Parameter: Type=System.Int32, Name=newSize
//    Member: BinarySearch
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//      Parameter: Type=T[], Name=array
//      Parameter: Type=T, Name=value
//    Member: BinarySearch
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//      Parameter: Type=T[], Name=array
//      Parameter: Type=T, Name=value
//      Parameter: Type=System.Collections.Generic.IComparer`1[T], Name=comparer

Imports System.Reflection

Module Module1
    Sub Main()
        ' This variable holds the amount of indenting that 
        ' should be used when displaying each line of information.
        Dim indent As Int32 = 0
        ' Display information about the EXE assembly.
        Dim a As Assembly = GetType(Module1).Assembly
        Display(indent, "Assembly identity={0}", a.FullName)
        Display(indent + 1, "Codebase={0}", a.CodeBase)

        ' Display the set of assemblies our assemblies reference.
        Dim an As AssemblyName
        Display(indent, "Referenced assemblies:")
        For Each an In a.GetReferencedAssemblies()
            Display(indent + 1, "Name={0}, Version={1}, Culture={2}, PublicKey token={3}", _
                an.Name, an.Version, an.CultureInfo.Name, BitConverter.ToString(an.GetPublicKeyToken))
        Next
        Display(indent, "")

        ' Display information about each assembly loading into this AppDomain.
        For Each a In AppDomain.CurrentDomain.GetAssemblies()
            Display(indent, "Assembly: {0}", a)

            ' Display information about each module of this assembly.
            Dim m As [Module]
            For Each m In a.GetModules(True)
                Display(indent + 1, "Module: {0}", m.Name)
            Next

            ' Display information about each type exported from this assembly.
            Dim t As Type
            indent += 1
            For Each t In a.GetExportedTypes()
                Display(0, "")
                Display(indent, "Type: {0}", t)

                ' For each type, show its members & their custom attributes.
                Dim mi As MemberInfo
                indent += 1
                For Each mi In t.GetMembers()
                    Display(indent, "Member: {0}", mi.Name)
                    DisplayAttributes(indent, mi)

                    ' If the member is a method, display information about its parameters.
                    Dim pi As ParameterInfo
                    If mi.MemberType = MemberTypes.Method Then
                        For Each pi In CType(mi, MethodInfo).GetParameters()
                            Display(indent + 1, "Parameter: Type={0}, Name={1}", pi.ParameterType, pi.Name)
                        Next
                    End If

                    ' If the member is a property, display information about the property's accessor methods.
                    If mi.MemberType = MemberTypes.Property Then
                        Dim am As MethodInfo
                        For Each am In CType(mi, PropertyInfo).GetAccessors()
                            Display(indent + 1, "Accessor method: {0}", am)
                        Next
                    End If
                Next
                indent -= 1
            Next
            indent -= 1
        Next
    End Sub

    ' Displays the custom attributes applied to the specified member.
    Sub DisplayAttributes(ByVal indent As Int32, ByVal mi As MemberInfo)
        ' Get the set of custom attributes; if none exist, just return.
        Dim attrs() As Object = mi.GetCustomAttributes(False)
        If attrs.Length = 0 Then Return

        ' Display the custom attributes applied to this member.
        Display(indent + 1, "Attributes:")
        Dim o As Object
        For Each o In attrs
            Display(indent + 2, "{0}", o.ToString())
        Next
    End Sub

    ' Display a formatted string indented by the specified amount.
    Sub Display(ByVal indent As Int32, ByVal format As String, ByVal ParamArray params() As Object)
        Console.Write(New String(" "c, indent * 2))
        Console.WriteLine(format, params)
    End Sub
End Module

'The output shown below is abbreviated.
'
'Assembly identity=Reflection, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null
'  Codebase=file:///C:/Reflection.exe
'Referenced assemblies:
'  Name=mscorlib, Version=1.0.5000.0, Culture=, PublicKey token=B7-7A-5C-56-19-34-E0-89
'  Name=Microsoft.VisualBasic, Version=7.0.5000.0, Culture=, PublicKey token=B0-3F-5F-7F-11-D5-0A-3A
'
'Assembly: mscorlib, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
'  Module: mscorlib.dll
'  Module: prc.nlp
'  Module: prcp.nlp
'  Module: ksc.nlp
'  Module: ctype.nlp
'  Module: xjis.nlp
'  Module: bopomofo.nlp
'  Module: culture.nlp
'  Module: region.nlp
'  Module: sortkey.nlp
'  Module: charinfo.nlp
'  Module: big5.nlp
'  Module: sorttbls.nlp
'  Module: l_intl.nlp
'  Module: l_except.nlp
'
'  Type: System.Object
'    Member: GetHashCode
'    Member: Equals
'      Parameter: Type=System.Object, Name=obj
'    Member: ToString
'    Member: Equals
'      Parameter: Type=System.Object, Name=objA
'      Parameter: Type=System.Object, Name=objB
'    Member: ReferenceEquals
'      Parameter: Type=System.Object, Name=objA
'      Parameter: Type=System.Object, Name=objB
'    Member: GetType
'    Member: .ctor
'
'  Type: System.ICloneable
'    Member: Clone
'
'  Type: System.Collections.IEnumerable
'    Member: GetEnumerator
'      Attributes:
'        System.Runtime.InteropServices.DispIdAttribute
'
'  Type: System.Collections.ICollection
'    Member: get_IsSynchronized
'    Member: get_SyncRoot
'    Member: get_Count
'    Member: CopyTo
'      Parameter: Type=System.Array, Name=array
'      Parameter: Type=System.Int32, Name=index
'    Member: Count
'      Accessor method: Int32 get_Count()
'    Member: SyncRoot
'      Accessor method: System.Object get_SyncRoot()
'    Member: IsSynchronized
'      Accessor method: Boolean get_IsSynchronized()
'

Комментарии

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

Замечание

Чтобы определить, является staticли свойство, необходимо получить MethodInfo объект доступа, get вызвав GetGetMethod метод или setGetSetMethod метод, и проверьте его IsStatic свойство.

В этом классе предполагается, что get методы доступа и set метода доступа свойства имеют определенные форматы. Подписи get методов set должны соответствовать следующему соглашению:

• Возвращаемый тип get метода и последний аргумент set метода должен быть идентичным. Это тип свойства.

• set Методы get должны иметь одинаковое число, тип и порядок индексов.

Если этот формат не используется, поведение GetValue методов и SetValue методов не определено.

PropertyInfo ВызовICustomAttributeProvider.GetCustomAttributes, когда inherit параметр GetCustomAttributes не true проходит иерархию типов. Используется System.Attribute для наследования пользовательских атрибутов.

Примечания для тех, кто реализует этот метод

При наследовании PropertyInfoот , необходимо переопределить следующие члены: GetValue(Object, Object[]), , SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo)GetAccessors(Boolean), GetGetMethod(Boolean)и GetSetMethod(Boolean)GetIndexParameters().

Конструкторы

Имя	Описание
PropertyInfo()	Инициализирует новый экземпляр класса PropertyInfo.

Свойства

Имя	Описание
Attributes	Возвращает атрибуты для этого свойства.
CanRead	Возвращает значение, указывающее, можно ли считывать свойство.
CanWrite	Возвращает значение, указывающее, можно ли записать свойство в.
CustomAttributes	Возвращает коллекцию, содержащую настраиваемые атрибуты этого члена. (Унаследовано от MemberInfo)
DeclaringType	Возвращает класс, объявляющий этот член. (Унаследовано от MemberInfo)
GetMethod	get Возвращает метод доступа для этого свойства.
IsCollectible	Возвращает значение, указывающее, ссылается ли этот MemberInfo объект на одну или несколько сборок, содержащихся в коллекционируемых AssemblyLoadContextобъектах. (Унаследовано от MemberInfo)
IsSpecialName	Возвращает значение, указывающее, является ли свойство специальным именем.
MemberType	MemberTypes Возвращает значение, указывающее, что этот элемент является свойством.
MetadataToken	Возвращает значение, определяющее элемент метаданных. (Унаследовано от MemberInfo)
Module	Возвращает модуль, в котором определяется тип, объявляющий элемент, представленный текущим MemberInfo . (Унаследовано от MemberInfo)
Name	Возвращает имя текущего элемента. (Унаследовано от MemberInfo)
PropertyType	Возвращает тип этого свойства.
ReflectedType	Возвращает объект класса, используемый для получения этого экземпляра MemberInfo. (Унаследовано от MemberInfo)
SetMethod	set Возвращает метод доступа для этого свойства.

Методы

Имя	Описание
Equals(Object)	Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту.
GetAccessors()	Возвращает массив, элементы которого отражают общедоступные get и set методы доступа свойства, отраженные текущим экземпляром.
GetAccessors(Boolean)	Возвращает массив, элементы которого отражают общедоступный и, если указанный, не открытый get и set методы доступа свойства, отраженные текущим экземпляром.
GetConstantValue()	Возвращает литеральное значение, связанное со свойством компилятором.
GetCustomAttributes(Boolean)	При переопределении в производном классе возвращает массив всех пользовательских атрибутов, примененных к этому элементу. (Унаследовано от MemberInfo)
GetCustomAttributes(Type, Boolean)	При переопределении в производном классе возвращает массив пользовательских атрибутов, применяемых к этому элементу, и определяется с помощью Type. (Унаследовано от MemberInfo)
GetCustomAttributesData()	Возвращает список CustomAttributeData объектов, представляющих данные о атрибутах, примененных к целевому элементу. (Унаследовано от MemberInfo)
GetGetMethod()	Возвращает общедоступный get метод доступа для этого свойства.
GetGetMethod(Boolean)	При переопределении в производном классе возвращает общедоступный или недоступный get метод доступа для этого свойства.
GetHashCode()	Возвращает хэш-код для этого экземпляра.
GetIndexParameters()	При переопределении в производном классе возвращает массив всех параметров индекса для свойства.
GetModifiedPropertyType()	Возвращает измененный тип объекта свойства.
GetOptionalCustomModifiers()	Возвращает массив типов, представляющих необязательные настраиваемые модификаторы свойства.
GetRawConstantValue()	Возвращает литеральное значение, связанное со свойством компилятором.
GetRequiredCustomModifiers()	Возвращает массив типов, представляющих необходимые настраиваемые модификаторы свойства.
GetSetMethod()	Возвращает общедоступный set метод доступа для этого свойства.
GetSetMethod(Boolean)	При переопределении в производном классе возвращает set метод доступа для этого свойства.
GetValue(Object, BindingFlags, Binder, Object[], CultureInfo)	При переопределении в производном классе возвращает значение свойства указанного объекта, имеющего указанную привязку, индекс и сведения о языке и региональных параметрах.
GetValue(Object, Object[])	Возвращает значение свойства указанного объекта с необязательными значениями индекса для индексированных свойств.
GetValue(Object)	Возвращает значение свойства указанного объекта.
HasSameMetadataDefinitionAs(MemberInfo)	Обнаруживает атрибуты свойства и предоставляет доступ к метаданным свойств. (Унаследовано от MemberInfo)
IsDefined(Type, Boolean)	При переопределении в производном классе указывает, применяется ли к этому члену один или несколько атрибутов указанного типа или производных типов. (Унаследовано от MemberInfo)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo)	При переопределении в производном классе задает значение свойства для указанного объекта, имеющего указанную привязку, индекс и сведения о языке и региональных параметрах.
SetValue(Object, Object, Object[])	Задает значение свойства указанного объекта с необязательными значениями индекса для свойств индекса.
SetValue(Object, Object)	Задает значение свойства указанного объекта.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Операторы

Имя	Описание
Equality(PropertyInfo, PropertyInfo)	Указывает, равны ли два PropertyInfo объекта.
Inequality(PropertyInfo, PropertyInfo)	Указывает, равны ли два PropertyInfo объекта.

Методы расширения

Имя	Описание
GetAccessors(PropertyInfo, Boolean)	Обнаруживает атрибуты свойства и предоставляет доступ к метаданным свойств.
GetAccessors(PropertyInfo)	Обнаруживает атрибуты свойства и предоставляет доступ к метаданным свойств.
GetCustomAttribute(MemberInfo, Type, Boolean)	Извлекает настраиваемый атрибут указанного типа, применяемого к указанному элементу, и при необходимости проверяет предки этого элемента.
GetCustomAttribute(MemberInfo, Type)	Извлекает настраиваемый атрибут указанного типа, применяемого к указанному элементу.
GetCustomAttribute<T>(MemberInfo, Boolean)	Извлекает настраиваемый атрибут указанного типа, применяемого к указанному элементу, и при необходимости проверяет предки этого элемента.
GetCustomAttribute<T>(MemberInfo)	Извлекает настраиваемый атрибут указанного типа, применяемого к указанному элементу.
GetCustomAttributes(MemberInfo, Boolean)	Извлекает коллекцию настраиваемых атрибутов, применяемых к указанному элементу, и при необходимости проверяет предки этого элемента.
GetCustomAttributes(MemberInfo, Type, Boolean)	Извлекает коллекцию настраиваемых атрибутов указанного типа, применяемого к указанному элементу, и при необходимости проверяет предки этого элемента.
GetCustomAttributes(MemberInfo, Type)	Извлекает коллекцию настраиваемых атрибутов указанного типа, применяемого к указанному элементу.
GetCustomAttributes(MemberInfo)	Извлекает коллекцию настраиваемых атрибутов, применяемых к указанному элементу.
GetCustomAttributes<T>(MemberInfo, Boolean)	Извлекает коллекцию настраиваемых атрибутов указанного типа, применяемого к указанному элементу, и при необходимости проверяет предки этого элемента.
GetCustomAttributes<T>(MemberInfo)	Извлекает коллекцию настраиваемых атрибутов указанного типа, применяемого к указанному элементу.
GetGetMethod(PropertyInfo, Boolean)	Обнаруживает атрибуты свойства и предоставляет доступ к метаданным свойств.
GetGetMethod(PropertyInfo)	Обнаруживает атрибуты свойства и предоставляет доступ к метаданным свойств.
GetMetadataToken(MemberInfo)	Возвращает маркер метаданных для данного члена, если он доступен.
GetSetMethod(PropertyInfo, Boolean)	Обнаруживает атрибуты свойства и предоставляет доступ к метаданным свойств.
GetSetMethod(PropertyInfo)	Обнаруживает атрибуты свойства и предоставляет доступ к метаданным свойств.
HasMetadataToken(MemberInfo)	Возвращает значение, указывающее, доступен ли маркер метаданных для указанного элемента.
IsDefined(MemberInfo, Type, Boolean)	Указывает, применяются ли пользовательские атрибуты указанного типа к указанному элементу и, при необходимости, применяются к его предкам.
IsDefined(MemberInfo, Type)	Указывает, применяются ли пользовательские атрибуты указанного типа к указанному элементу.

Потокобезопасность

Этот тип является потокобезопасной.