PropertyInfo Třída

Definice

Obor názvů:

System.Reflection

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

PropertyInfo.cs

Vyhledá atributy vlastnosti a poskytuje přístup k metadatům vlastností.

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

Dědičnost

Object

MemberInfo

PropertyInfo

Odvozené

Microsoft.JScript.COMPropertyInfo

System.Reflection.Emit.PropertyBuilder

Příklady

Tento příklad ukazuje, jak pomocí různých tříd reflexe analyzovat metadata obsažená v sestavení.

Poznámka:

Tento příklad generuje přibližně 55 000 řádků dat, které můžete přesměrovat na textový soubor na příkazovém řádku následujícím způsobem: 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()
'

Poznámky

Vlastnosti jsou logicky stejné jako pole. Vlastnost je pojmenovaný aspekt stavu objektu, jehož hodnota je obvykle přístupná prostřednictvím get a set přístupových objektů. Vlastnosti můžou být jen pro čtení, v takovém případě není podporována rutina sady.

Poznámka:

Chcete-li zjistit, zda je staticvlastnost , musíte získat MethodInfo pro objekt get nebo set přístup, voláním GetGetMethod nebo metodou GetSetMethod a prozkoumáte jeho IsStatic vlastnost.

Několik metod v této třídě předpokládá, že get přístupové a set přístupové metody vlastnosti mají určité formáty. Podpisy get a set metody musí odpovídat následující konvenci:

• Návratový get typ metody a poslední argument set metody musí být shodný. Toto je typ vlastnosti.

• set Tyto get metody musí mít stejné číslo, typ a pořadí indexů.

Pokud tento formát není dodržen, chování GetValue metod a SetValue metod není definováno.

Volání ICustomAttributeProvider.GetCustomAttributes , PropertyInfo pokud inherit parametr GetCustomAttributes není true procházet hierarchii typů. Slouží System.Attribute k dědění vlastních atributů.

Poznámky pro implementátory

Při dědění z PropertyInfo, musíte přepsat následující členy: GetValue(Object, Object[]), SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo), GetAccessors(Boolean), GetGetMethod(Boolean), GetSetMethod(Boolean), a GetIndexParameters().

Konstruktory

Name	Description
PropertyInfo()	Inicializuje novou instanci PropertyInfo třídy.

Vlastnosti

Name	Description
Attributes	Získá atributy pro tuto vlastnost.
CanRead	Získá hodnotu určující, zda vlastnost lze číst.
CanWrite	Získá hodnotu určující, zda vlastnost lze zapsat do.
CustomAttributes	Získá kolekci, která obsahuje vlastní atributy tohoto člena. (Zděděno od MemberInfo)
DeclaringType	Získá třídu, která deklaruje tohoto člena. (Zděděno od MemberInfo)
GetMethod	Získá přístup pro get tuto vlastnost.
IsCollectible	Získá hodnotu, která označuje, zda tento MemberInfo objekt odkazuje na jedno nebo více sestavení uložených v collectible AssemblyLoadContext. (Zděděno od MemberInfo)
IsSpecialName	Získá hodnotu určující, zda je vlastnost speciální název.
MemberType	MemberTypes Získá hodnotu označující, že tento člen je vlastnost.
MetadataToken	Získá hodnotu, která identifikuje prvek metadat. (Zděděno od MemberInfo)
Module	Získá modul, ve kterém typ, který deklaruje člen reprezentovaný proudem MemberInfo je definován. (Zděděno od MemberInfo)
Name	Získá název aktuálního člena. (Zděděno od MemberInfo)
PropertyType	Získá typ této vlastnosti.
ReflectedType	Získá objekt třídy, který byl použit k získání této instance MemberInfo. (Zděděno od MemberInfo)
SetMethod	Získá přístup pro set tuto vlastnost.

Metody

Name	Description
Equals(Object)	Vrátí hodnotu, která určuje, zda je tato instance rovna zadanému objektu.
GetAccessors()	Vrátí pole, jehož prvky odrážejí veřejné get objekty a set přístupové objekty vlastnosti odráží aktuální instance.
GetAccessors(Boolean)	Vrátí pole, jehož prvky odrážejí veřejnost a pokud jsou zadány, neveřejné get a set přístupové objekty vlastnosti odráží aktuální instance.
GetConstantValue()	Vrátí hodnotu literálu přidruženou k vlastnosti kompilátorem.
GetCustomAttributes(Boolean)	Při přepsání v odvozené třídě vrátí pole všech vlastních atributů použitých na tento člen. (Zděděno od MemberInfo)
GetCustomAttributes(Type, Boolean)	Při přepsání v odvozené třídě vrátí pole vlastních atributů použitých na tento člen a identifikovaný .Type (Zděděno od MemberInfo)
GetCustomAttributesData()	Vrátí seznam CustomAttributeData objektů představujících data o atributech, které byly použity na cílového člena. (Zděděno od MemberInfo)
GetGetMethod()	Vrátí veřejný get přístup pro tuto vlastnost.
GetGetMethod(Boolean)	Při přepsání v odvozené třídě vrátí veřejné nebo neveřejné get přístupové objekty pro tuto vlastnost.
GetHashCode()	Vrátí kód hash pro tuto instanci.
GetIndexParameters()	Při přepsání v odvozené třídě vrátí pole všech parametrů indexu pro vlastnost.
GetModifiedPropertyType()	Získá upravený typ tohoto objektu vlastnosti.
GetOptionalCustomModifiers()	Vrátí pole typů představujících volitelné vlastní modifikátory vlastnosti.
GetRawConstantValue()	Vrátí hodnotu literálu přidruženou k vlastnosti kompilátorem.
GetRequiredCustomModifiers()	Vrátí pole typů představujících požadované vlastní modifikátory vlastnosti.
GetSetMethod()	Vrátí veřejný set přístup pro tuto vlastnost.
GetSetMethod(Boolean)	Při přepsání v odvozené třídě vrátí set přístup pro tuto vlastnost.
GetValue(Object, BindingFlags, Binder, Object[], CultureInfo)	Při přepsání v odvozené třídě vrátí hodnotu vlastnosti zadaného objektu, který má zadané vazby, index a informace specifické pro jazykovou verzi.
GetValue(Object, Object[])	Vrátí hodnotu vlastnosti zadaného objektu s volitelnými hodnotami indexu pro indexované vlastnosti.
GetValue(Object)	Vrátí hodnotu vlastnosti zadaného objektu.
HasSameMetadataDefinitionAs(MemberInfo)	Vyhledá atributy vlastnosti a poskytuje přístup k metadatům vlastností. (Zděděno od MemberInfo)
IsDefined(Type, Boolean)	Při přepsání v odvozené třídě určuje, zda jeden nebo více atributů zadaného typu nebo jeho odvozených typů se použije na tento člen. (Zděděno od MemberInfo)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo)	Při přepsání v odvozené třídě nastaví hodnotu vlastnosti pro zadaný objekt, který má zadané vazby, index a informace specifické pro jazykovou verzi.
SetValue(Object, Object, Object[])	Nastaví hodnotu vlastnosti zadaného objektu s volitelnými hodnotami indexu pro vlastnosti indexu.
SetValue(Object, Object)	Nastaví hodnotu vlastnosti zadaného objektu.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Operátory

Name	Description
Equality(PropertyInfo, PropertyInfo)	Určuje, zda jsou dva PropertyInfo objekty stejné.
Inequality(PropertyInfo, PropertyInfo)	Určuje, zda jsou dva PropertyInfo objekty nerovny.

Metody rozšíření

Name	Description
GetAccessors(PropertyInfo, Boolean)	Vyhledá atributy vlastnosti a poskytuje přístup k metadatům vlastností.
GetAccessors(PropertyInfo)	Vyhledá atributy vlastnosti a poskytuje přístup k metadatům vlastností.
GetCustomAttribute(MemberInfo, Type, Boolean)	Načte vlastní atribut zadaného typu, který se použije u zadaného členu, a volitelně zkontroluje předky daného člena.
GetCustomAttribute(MemberInfo, Type)	Načte vlastní atribut zadaného typu, který se použije na zadaný člen.
GetCustomAttribute<T>(MemberInfo, Boolean)	Načte vlastní atribut zadaného typu, který se použije u zadaného členu, a volitelně zkontroluje předky daného člena.
GetCustomAttribute<T>(MemberInfo)	Načte vlastní atribut zadaného typu, který se použije na zadaný člen.
GetCustomAttributes(MemberInfo, Boolean)	Načte kolekci vlastních atributů, které se použijí na zadaného člena, a volitelně zkontroluje předky daného člena.
GetCustomAttributes(MemberInfo, Type, Boolean)	Načte kolekci vlastních atributů zadaného typu, které se použijí na zadaný člen, a volitelně zkontroluje nadřazené objekty daného člena.
GetCustomAttributes(MemberInfo, Type)	Načte kolekci vlastních atributů zadaného typu, které se použijí na zadaný člen.
GetCustomAttributes(MemberInfo)	Načte kolekci vlastních atributů, které se použijí na zadaný člen.
GetCustomAttributes<T>(MemberInfo, Boolean)	Načte kolekci vlastních atributů zadaného typu, které se použijí na zadaný člen, a volitelně zkontroluje nadřazené objekty daného člena.
GetCustomAttributes<T>(MemberInfo)	Načte kolekci vlastních atributů zadaného typu, které se použijí na zadaný člen.
GetGetMethod(PropertyInfo, Boolean)	Vyhledá atributy vlastnosti a poskytuje přístup k metadatům vlastností.
GetGetMethod(PropertyInfo)	Vyhledá atributy vlastnosti a poskytuje přístup k metadatům vlastností.
GetMetadataToken(MemberInfo)	Získá token metadat pro daného člena, pokud je k dispozici.
GetSetMethod(PropertyInfo, Boolean)	Vyhledá atributy vlastnosti a poskytuje přístup k metadatům vlastností.
GetSetMethod(PropertyInfo)	Vyhledá atributy vlastnosti a poskytuje přístup k metadatům vlastností.
HasMetadataToken(MemberInfo)	Vrátí hodnotu, která určuje, zda je token metadat k dispozici pro zadaného člena.
IsDefined(MemberInfo, Type, Boolean)	Určuje, zda se vlastní atributy zadaného typu použijí na zadaný člen a volitelně se použijí na jeho nadřazené objekty.
IsDefined(MemberInfo, Type)	Určuje, zda jsou u zadaného člena použity vlastní atributy zadaného typu.

Bezpečný přístup z více vláken

Tento typ je bezpečný pro přístup z více vláken.