PropertyInfo Classe

Définition

Espace de noms:

System.Reflection

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

PropertyInfo.cs

Découvre les attributs d’une propriété et fournit l’accès aux métadonnées de propriété.

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

Héritage

Object

MemberInfo

PropertyInfo

Dérivé

Microsoft.JScript.COMPropertyInfo

System.Reflection.Emit.PropertyBuilder

Exemples

Cet exemple montre comment utiliser différentes classes de réflexion pour analyser les métadonnées contenues dans un assembly.

Note

Cet exemple génère environ 55 000 lignes de données, que vous pouvez rediriger vers un fichier texte à l’invite de commandes, comme suit : 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()
'

Remarques

Les propriétés sont logiquement identiques aux champs. Une propriété est un aspect nommé de l’état d’un objet dont la valeur est généralement accessible par le biais get et set les accesseurs. Les propriétés peuvent être en lecture seule, auquel cas une routine de jeu n’est pas prise en charge.

Note

Pour déterminer si une propriété est static, vous devez obtenir le ou l’accesseur getsetMethodInfo, en appelant la GetGetMethod ou la GetSetMethod méthode, et examiner sa IsStatic propriété.

Plusieurs méthodes de cette classe supposent que les get méthodes d’accesseur et set d’accesseur d’une propriété ont certains formats. Les signatures des méthodes et set des get méthodes doivent correspondre à la convention suivante :

• Le type de retour de la get méthode et le dernier argument de la set méthode doivent être identiques. Il s’agit du type de la propriété.

• Les méthodes et set les get méthodes doivent avoir le même nombre, le même type et l’ordre des index.

Si ce format n’est pas suivi, le comportement des méthodes et SetValue les GetValue méthodes n’est pas défini.

PropertyInfo L’appel ICustomAttributeProvider.GetCustomAttributes lorsque le inherit paramètre de GetCustomAttributes l’objet true ne marche pas dans la hiérarchie de type. Permet System.Attribute d’hériter des attributs personnalisés.

Notes pour les responsables de l’implémentation

Lorsque vous héritez de PropertyInfo, vous devez remplacer les membres suivants : GetValue(Object, Object[]), , SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo)GetAccessors(Boolean), GetGetMethod(Boolean), GetSetMethod(Boolean)et GetIndexParameters().

Constructeurs

Nom	Description
PropertyInfo()	Initialise une nouvelle instance de la classe PropertyInfo.

Propriétés

Nom	Description
Attributes	Obtient les attributs de cette propriété.
CanRead	Obtient une valeur indiquant si la propriété peut être lue.
CanWrite	Obtient une valeur indiquant si la propriété peut être écrite.
CustomAttributes	Obtient une collection qui contient les attributs personnalisés de ce membre. (Hérité de MemberInfo)
DeclaringType	Obtient la classe qui déclare ce membre. (Hérité de MemberInfo)
GetMethod	Obtient l’accesseur get pour cette propriété.
IsCollectible	Obtient une valeur qui indique si cet MemberInfo objet fait référence à un ou plusieurs assemblys conservés dans une collection AssemblyLoadContext. (Hérité de MemberInfo)
IsSpecialName	Obtient une valeur indiquant si la propriété est le nom spécial.
MemberType	Obtient une MemberTypes valeur indiquant que ce membre est une propriété.
MetadataToken	Obtient une valeur qui identifie un élément de métadonnées. (Hérité de MemberInfo)
Module	Obtient le module dans lequel le type qui déclare le membre représenté par le courant MemberInfo est défini. (Hérité de MemberInfo)
Name	Obtient le nom du membre actuel. (Hérité de MemberInfo)
PropertyType	Obtient le type de cette propriété.
ReflectedType	Obtient l’objet de classe utilisé pour obtenir cette instance de MemberInfo. (Hérité de MemberInfo)
SetMethod	Obtient l’accesseur set pour cette propriété.

Méthodes

Nom	Description
Equals(Object)	Retourne une valeur qui indique si cette instance est égale à un objet spécifié.
GetAccessors()	Retourne un tableau dont les éléments reflètent le public get et set les accesseurs de la propriété reflétées par l’instance actuelle.
GetAccessors(Boolean)	Retourne un tableau dont les éléments reflètent le public et, s’ils sont spécifiés, non publics get et set accesseurs de la propriété reflétées par l’instance actuelle.
GetConstantValue()	Retourne une valeur littérale associée à la propriété par un compilateur.
GetCustomAttributes(Boolean)	En cas de substitution dans une classe dérivée, retourne un tableau de tous les attributs personnalisés appliqués à ce membre. (Hérité de MemberInfo)
GetCustomAttributes(Type, Boolean)	En cas de substitution dans une classe dérivée, retourne un tableau d’attributs personnalisés appliqués à ce membre et identifié par Type. (Hérité de MemberInfo)
GetCustomAttributesData()	Retourne une liste d’objets CustomAttributeData représentant des données sur les attributs qui ont été appliqués au membre cible. (Hérité de MemberInfo)
GetGetMethod()	Retourne l’accesseur public get pour cette propriété.
GetGetMethod(Boolean)	En cas de substitution dans une classe dérivée, retourne l’accesseur public ou non public get pour cette propriété.
GetHashCode()	Retourne le code de hachage pour cette instance.
GetIndexParameters()	En cas de substitution dans une classe dérivée, retourne un tableau de tous les paramètres d’index de la propriété.
GetModifiedPropertyType()	Obtient le type modifié de cet objet de propriété.
GetOptionalCustomModifiers()	Retourne un tableau de types représentant les modificateurs personnalisés facultatifs de la propriété.
GetRawConstantValue()	Retourne une valeur littérale associée à la propriété par un compilateur.
GetRequiredCustomModifiers()	Retourne un tableau de types représentant les modificateurs personnalisés requis de la propriété.
GetSetMethod()	Retourne l’accesseur public set pour cette propriété.
GetSetMethod(Boolean)	En cas de substitution dans une classe dérivée, retourne l’accesseur set pour cette propriété.
GetValue(Object, BindingFlags, Binder, Object[], CultureInfo)	En cas de substitution dans une classe dérivée, retourne la valeur de propriété d’un objet spécifié qui a les informations spécifiques à la culture, à l’index et à la liaison spécifiées.
GetValue(Object, Object[])	Retourne la valeur de propriété d’un objet spécifié avec des valeurs d’index facultatives pour les propriétés indexées.
GetValue(Object)	Retourne la valeur de propriété d’un objet spécifié.
HasSameMetadataDefinitionAs(MemberInfo)	Découvre les attributs d’une propriété et fournit l’accès aux métadonnées de propriété. (Hérité de MemberInfo)
IsDefined(Type, Boolean)	En cas de substitution dans une classe dérivée, indique si un ou plusieurs attributs du type spécifié ou de ses types dérivés sont appliqués à ce membre. (Hérité de MemberInfo)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo)	En cas de substitution dans une classe dérivée, définit la valeur de propriété d’un objet spécifié qui a les informations spécifiques à la culture, à l’index et à la liaison spécifiées.
SetValue(Object, Object, Object[])	Définit la valeur de propriété d’un objet spécifié avec des valeurs d’index facultatives pour les propriétés d’index.
SetValue(Object, Object)	Définit la valeur de propriété d’un objet spécifié.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Opérateurs

Nom	Description
Equality(PropertyInfo, PropertyInfo)	Indique si deux PropertyInfo objets sont égaux.
Inequality(PropertyInfo, PropertyInfo)	Indique si deux PropertyInfo objets ne sont pas égaux.

Méthodes d’extension

Nom	Description
GetAccessors(PropertyInfo, Boolean)	Découvre les attributs d’une propriété et fournit l’accès aux métadonnées de propriété.
GetAccessors(PropertyInfo)	Découvre les attributs d’une propriété et fournit l’accès aux métadonnées de propriété.
GetCustomAttribute(MemberInfo, Type, Boolean)	Récupère un attribut personnalisé d’un type spécifié appliqué à un membre spécifié et inspecte éventuellement les ancêtres de ce membre.
GetCustomAttribute(MemberInfo, Type)	Récupère un attribut personnalisé d’un type spécifié appliqué à un membre spécifié.
GetCustomAttribute<T>(MemberInfo, Boolean)	Récupère un attribut personnalisé d’un type spécifié appliqué à un membre spécifié et inspecte éventuellement les ancêtres de ce membre.
GetCustomAttribute<T>(MemberInfo)	Récupère un attribut personnalisé d’un type spécifié appliqué à un membre spécifié.
GetCustomAttributes(MemberInfo, Boolean)	Récupère une collection d’attributs personnalisés appliqués à un membre spécifié et inspecte éventuellement les ancêtres de ce membre.
GetCustomAttributes(MemberInfo, Type, Boolean)	Récupère une collection d’attributs personnalisés d’un type spécifié qui sont appliqués à un membre spécifié et inspecte éventuellement les ancêtres de ce membre.
GetCustomAttributes(MemberInfo, Type)	Récupère une collection d’attributs personnalisés d’un type spécifié qui sont appliqués à un membre spécifié.
GetCustomAttributes(MemberInfo)	Récupère une collection d’attributs personnalisés appliqués à un membre spécifié.
GetCustomAttributes<T>(MemberInfo, Boolean)	Récupère une collection d’attributs personnalisés d’un type spécifié qui sont appliqués à un membre spécifié et inspecte éventuellement les ancêtres de ce membre.
GetCustomAttributes<T>(MemberInfo)	Récupère une collection d’attributs personnalisés d’un type spécifié qui sont appliqués à un membre spécifié.
GetGetMethod(PropertyInfo, Boolean)	Découvre les attributs d’une propriété et fournit l’accès aux métadonnées de propriété.
GetGetMethod(PropertyInfo)	Découvre les attributs d’une propriété et fournit l’accès aux métadonnées de propriété.
GetMetadataToken(MemberInfo)	Obtient un jeton de métadonnées pour le membre donné, le cas échéant.
GetSetMethod(PropertyInfo, Boolean)	Découvre les attributs d’une propriété et fournit l’accès aux métadonnées de propriété.
GetSetMethod(PropertyInfo)	Découvre les attributs d’une propriété et fournit l’accès aux métadonnées de propriété.
HasMetadataToken(MemberInfo)	Retourne une valeur qui indique si un jeton de métadonnées est disponible pour le membre spécifié.
IsDefined(MemberInfo, Type, Boolean)	Indique si les attributs personnalisés d’un type spécifié sont appliqués à un membre spécifié et, éventuellement, appliqués à ses ancêtres.
IsDefined(MemberInfo, Type)	Indique si les attributs personnalisés d’un type spécifié sont appliqués à un membre spécifié.

Cohérence de thread

Ce type est thread safe.