Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

PropertyInfo, classe

 

Identifie les attributs d'une propriété et permet d'accéder aux métadonnées de propriété.

Espace de noms:   System.Reflection
Assembly:  mscorlib (dans mscorlib.dll)


[SerializableAttribute]
[ClassInterfaceAttribute(ClassInterfaceType.None)]
[ComVisibleAttribute(true)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public abstract class PropertyInfo : MemberInfo, _PropertyInfo

NomDescription
System_CAPS_protmethodPropertyInfo()

Initialise une nouvelle instance de la classe PropertyInfo.

NomDescription
System_CAPS_pubpropertyAttributes

Obtient les attributs de cette propriété.

System_CAPS_pubpropertyCanRead

Obtient une valeur indiquant si la propriété peut être lue.

System_CAPS_pubpropertyCanWrite

Obtient une valeur indiquant s'il est possible d'écrire dans la propriété.

System_CAPS_pubpropertyCustomAttributes

Obtient une collection qui contient les attributs personnalisés du membre.(Hérité de MemberInfo.)

System_CAPS_pubpropertyDeclaringType

Obtient la classe qui déclare ce membre.(Hérité de MemberInfo.)

System_CAPS_pubpropertyGetMethod

Obtient l'accesseur get de cette propriété.

System_CAPS_pubpropertyIsSpecialName

Obtient une valeur indiquant si la propriété correspond au nom spécial.

System_CAPS_pubpropertyMemberType

Obtient une valeur MemberTypes indiquant que ce membre est une propriété.(Remplace MemberInfo.MemberType.)

System_CAPS_pubpropertyMetadataToken

Obtient une valeur qui identifie un élément de métadonnées.(Hérité de MemberInfo.)

System_CAPS_pubpropertyModule

Obtient le module dans lequel le type qui déclare le membre représenté par les MemberInfo est défini.(Hérité de MemberInfo.)

System_CAPS_pubpropertyName

Obtient le nom du membre actuel.(Hérité de MemberInfo.)

System_CAPS_pubpropertyPropertyType

Obtient le type de cette propriété.

System_CAPS_pubpropertyReflectedType

Obtient l'objet de classe qui a été utilisé pour obtenir cette instance de MemberInfo.(Hérité de MemberInfo.)

System_CAPS_pubpropertySetMethod

Obtient l'accesseur set de cette propriété.

NomDescription
System_CAPS_pubmethodEquals(Object)

Retourne une valeur qui indique si cette instance est égale à un objet spécifié.(Remplace MemberInfo.Equals(Object).)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetAccessors()

Retourne un tableau dont les éléments réfléchissent les accesseurs publics get et set de la propriété réfléchie par l’instance actuelle.

System_CAPS_pubmethodGetAccessors(Boolean)

Retourne un tableau dont les éléments réfléchissent les accesseurs get, set publics et, le cas échéant, non publics, ainsi que d’autres accesseurs de la propriété réfléchie par l’instance actuelle.

System_CAPS_pubmethodGetConstantValue()

Retourne une valeur littérale associée à la propriété par un compilateur.

System_CAPS_pubmethodGetCustomAttributes(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.)

System_CAPS_pubmethodGetCustomAttributes(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és par Type.(Hérité de MemberInfo.)

System_CAPS_pubmethodGetCustomAttributesData()

Retourne une liste de CustomAttributeData objets représentant des données relatives aux attributs qui ont été appliqués au membre cible.(Hérité de MemberInfo.)

System_CAPS_pubmethodGetGetMethod()

Retourne l'accesseur get public de cette propriété.

System_CAPS_pubmethodGetGetMethod(Boolean)

En cas de substitution dans une classe dérivée, retourne l'accesseur get public ou non public de cette propriété.

System_CAPS_pubmethodGetHashCode()

Retourne le code de hachage de cette instance.(Remplace MemberInfo.GetHashCode().)

System_CAPS_pubmethodGetIndexParameters()

En cas de substitution dans une classe dérivée, retourne un tableau de tous les paramètres d'index de cette propriété.

System_CAPS_pubmethodGetOptionalCustomModifiers()

Retourne un tableau de types représentant les modificateurs personnalisés facultatifs de la propriété.

System_CAPS_pubmethodGetRawConstantValue()

Retourne une valeur littérale associée à la propriété par un compilateur.

System_CAPS_pubmethodGetRequiredCustomModifiers()

Retourne un tableau de types représentant les modificateurs personnalisés requis de la propriété.

System_CAPS_pubmethodGetSetMethod()

Retourne l'accesseur set public de cette propriété.

System_CAPS_pubmethodGetSetMethod(Boolean)

En cas de substitution dans une classe dérivée, retourne l'accesseur set de cette propriété.

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodGetValue(Object)

Retourne la valeur de la propriété d'un objet spécifié.

System_CAPS_pubmethodGetValue(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 possède la liaison, l'index et les informations propres à la culture spécifiés.

System_CAPS_pubmethodGetValue(Object, Object[])

Retourne la valeur de la propriété d'un objet spécifié avec des valeurs d'index facultatives pour les propriétés indexées.

System_CAPS_pubmethodIsDefined(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ées à ce membre.(Hérité de MemberInfo.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodSetValue(Object, Object)

Définit la valeur de la propriété d'un objet spécifié.

System_CAPS_pubmethodSetValue(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 possède la liaison, l'index et les informations propres à la culture spécifiés.

System_CAPS_pubmethodSetValue(Object, Object, Object[])

Définit la valeur de la propriété d'un objet spécifié avec des valeurs d'index facultatives pour les propriétés de l'index.

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

NomDescription
System_CAPS_puboperatorSystem_CAPS_staticEquality(PropertyInfo, PropertyInfo)

Indique si deux objets PropertyInfo sont égaux.

System_CAPS_puboperatorSystem_CAPS_staticInequality(PropertyInfo, PropertyInfo)

Indique si deux objets PropertyInfo ne sont pas égaux.

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethod_MemberInfo.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch.(Hérité de MemberInfo.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_MemberInfo.GetType()

Obtient un Type objet représentant le MemberInfo (classe).(Hérité de MemberInfo.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_MemberInfo.GetTypeInfo(UInt32, UInt32, IntPtr)

Récupère les informations de type pour un objet, qui peuvent être utilisées ensuite pour obtenir les informations de type d'une interface.(Hérité de MemberInfo.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_MemberInfo.GetTypeInfoCount(UInt32)

Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1).(Hérité de MemberInfo.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_MemberInfo.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fournit l'accès aux propriétés et aux méthodes exposées par un objet.(Hérité de MemberInfo.)

System_CAPS_pubinterfaceSystem_CAPS_privmethod_PropertyInfo.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch.

System_CAPS_pubinterfaceSystem_CAPS_privmethod_PropertyInfo.GetType()

Obtient un objet Type qui représente le type PropertyInfo.

System_CAPS_pubinterfaceSystem_CAPS_privmethod_PropertyInfo.GetTypeInfo(UInt32, UInt32, IntPtr)

Récupère les informations de type pour un objet, qui peuvent être utilisées ensuite pour obtenir les informations de type d'une interface.

System_CAPS_pubinterfaceSystem_CAPS_privmethod_PropertyInfo.GetTypeInfoCount(UInt32)

Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_PropertyInfo.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fournit l'accès aux propriétés et aux méthodes exposées par un objet.

NomDescription
System_CAPS_pubmethodGetCustomAttribute(Type)

Surchargé. Récupère un attribut personnalisé d’un type spécifié qui est appliqué à un membre spécifié.(Défini par CustomAttributeExtensions.)

System_CAPS_pubmethodGetCustomAttribute(Type, Boolean)

Surchargé. Récupère un attribut personnalisé d’un type spécifié qui est appliqué à un membre spécifié et éventuellement inspecte les ancêtres de ce membre.(Défini par CustomAttributeExtensions.)

System_CAPS_pubmethodGetCustomAttribute<T>()

Surchargé. Récupère un attribut personnalisé d’un type spécifié qui est appliqué à un membre spécifié.(Défini par CustomAttributeExtensions.)

System_CAPS_pubmethodGetCustomAttribute<T>(Boolean)

Surchargé. Récupère un attribut personnalisé d’un type spécifié qui est appliqué à un membre spécifié et éventuellement inspecte les ancêtres de ce membre.(Défini par CustomAttributeExtensions.)

System_CAPS_pubmethodGetCustomAttributes()

Surchargé. Récupère une collection d’attributs personnalisés qui sont appliqués à un membre spécifié.(Défini par CustomAttributeExtensions.)

System_CAPS_pubmethodGetCustomAttributes(Type)

Surchargé. Récupère une collection d'attributs personnalisés d'un type spécifié qui sont appliqués à un membre spécifié.(Défini par CustomAttributeExtensions.)

System_CAPS_pubmethodGetCustomAttributes<T>(Boolean)

Surchargé. Récupère une collection d’attributs personnalisés d’un type spécifié qui sont appliqués à un membre spécifié et éventuellement inspecte les ancêtres de ce membre.(Défini par CustomAttributeExtensions.)

System_CAPS_pubmethodIsDefined(Type)

Surchargé. Indique si des attributs personnalisés d’un type spécifié sont appliqués à un membre spécifié.(Défini par CustomAttributeExtensions.)

Propriétés sont logiquement les mêmes champs. Une propriété est un aspect nommé de l'état d'un objet dont la valeur est généralement accessible via get et set accesseurs. Propriétés peuvent être en lecture seule, auquel cas une routine de jeu n'est pas pris en charge.

System_CAPS_noteRemarque

Pour déterminer si une propriété est static, vous devez obtenir le MethodInfo pour le get ou set accesseur, en appelant le GetGetMethod ou le GetSetMethod (méthode) et examinez ses IsStatic propriété.

Plusieurs méthodes de cette classe supposent que le get accesseur et set méthodes d'accesseur d'une propriété utilisent des formats spécifiques. Les signatures de la get et set méthodes doivent respecter les conventions suivantes :

  • Le type de retour de la get méthode et le dernier argument de la set méthode doit être identique. C'est le type de la propriété.

  • Le get et set les méthodes doivent avoir le même nombre, type et ordre d'index.

Si ce format n'est pas suivi, le comportement de la GetValue et SetValue méthodes n'est pas défini.

Appel de ICustomAttributeProvider.GetCustomAttributes sur PropertyInfo lorsque le inherit paramètre de GetCustomAttributes est true ne parcourt pas la hiérarchie des types. Utilisez System.Attribute pour hériter des attributs personnalisés.

Remarques à l'attention des héritiers :

Lorsque vous héritez PropertyInfo, vous devez substituer les membres suivants : GetValue, SetValue, GetAccessors, GetGetMethod, GetSetMethod, et GetIndexParameters.

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

System_CAPS_noteRemarque

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

SecurityAction.InheritanceDemand

for full trust for inheritors. This class cannot be inherited by partially trusted code.

Universal Windows Platform
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Portable Class Library
Pris en charge dans : portable .NET platforms
Silverlight
Disponible depuis 2.0
Windows Phone Silverlight
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1

Ce type est thread-safe.

Retour au début
Afficher: