DescriptionAttribute Classe

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

Source:

DescriptionAttribute.cs

Spécifie une description pour une propriété ou un événement.

public ref class DescriptionAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.All)]
public class DescriptionAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.All)>]
type DescriptionAttribute = class
    inherit Attribute

Public Class DescriptionAttribute
Inherits Attribute

Héritage

Object

Attribute

DescriptionAttribute

Dérivé

Microsoft.VisualBasic.Compatibility.VB6.SRDescriptionAttribute

System.Data.DataSysDescriptionAttribute

System.Diagnostics.MonitoringDescriptionAttribute

System.DirectoryServices.DSDescriptionAttribute

System.IO.IODescriptionAttribute

System.Messaging.MessagingDescriptionAttribute

System.ServiceProcess.ServiceProcessDescriptionAttribute

System.Timers.TimersDescriptionAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple suivant crée la MyImage propriété . La propriété a deux attributs, un DescriptionAttribute et un CategoryAttribute.

public:
   property Image^ MyImage 
   {
      [Description("The image associated with the control"),Category("Appearance")]
      Image^ get()
      {
         // Insert code here.
         return image1;
      }

      void set( Image^ value )
      {
         // Insert code here.
      }
   }

[Description("The image associated with the control"),Category("Appearance")] 
 public Image MyImage {
    get {
       // Insert code here.
       return image1;
    }
    set {
       // Insert code here.
    }
 }

<Description("The image associated with the control"), _
    Category("Appearance")> _
Public Property MyImage() As Image
    Get
        ' Insert code here.
        Return image1
    End Get
    Set
        ' Insert code here.
    End Set 
End Property

L’exemple suivant obtient la description de MyImage. Tout d’abord, le code obtient un PropertyDescriptorCollection avec toutes les propriétés de l’objet. Ensuite, il s’indexe dans pour PropertyDescriptorCollection obtenir MyImage. Ensuite, il retourne les attributs de cette propriété et les enregistre dans la variable d’attributs.

L’exemple imprime ensuite la description en récupérant à partir de et AttributeCollectionen l’écrivant DescriptionAttribute dans l’écran de la console.

// Gets the attributes for the property.
AttributeCollection^ attributes = TypeDescriptor::GetProperties( this )[ "MyImage" ]->Attributes;

/* Prints the description by retrieving the DescriptionAttribute 
      * from the AttributeCollection. */
DescriptionAttribute^ myAttribute = dynamic_cast<DescriptionAttribute^>(attributes[ DescriptionAttribute::typeid ]);
Console::WriteLine( myAttribute->Description );

// Gets the attributes for the property.
 AttributeCollection attributes = 
    TypeDescriptor.GetProperties(this)["MyImage"].Attributes;
 
 /* Prints the description by retrieving the DescriptionAttribute 
  * from the AttributeCollection. */
 DescriptionAttribute myAttribute = 
    (DescriptionAttribute)attributes[typeof(DescriptionAttribute)];
 Console.WriteLine(myAttribute.Description);

' Gets the attributes for the property.
Dim attributes As AttributeCollection = _
    TypeDescriptor.GetProperties(Me)("MyImage").Attributes

' Prints the description by retrieving the DescriptionAttribute
' from the AttributeCollection. 
Dim myAttribute As DescriptionAttribute = _
    CType(attributes(GetType(DescriptionAttribute)), DescriptionAttribute)
Console.WriteLine(myAttribute.Description)

Remarques

Un concepteur visuel peut afficher la description spécifiée lors du référencement du membre du composant, par exemple dans un Fenêtre Propriétés. Appelez Description pour accéder à la valeur de cet attribut.

Pour plus d’informations, consultez Attributs.

Constructeurs

DescriptionAttribute()	Initialise une nouvelle instance de la classe DescriptionAttribute sans paramètres.
DescriptionAttribute(String)	Initialise une nouvelle instance de la classe DescriptionAttribute avec une description.

Champs

Default

Spécifie la valeur par défaut de DescriptionAttribute (chaîne vide ("")). Ce champ static est en lecture seule.

Propriétés

Description	Obtient la description stockée dans cet attribut.
DescriptionValue	Obtient ou définit la chaîne stockée comme description.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute. (Hérité de Attribute)

Méthodes

Equals(Object)	Retourne une valeur indiquant si la valeur de l'objet donné est égale au DescriptionAttribute en cours.
GetHashCode()	Retourne le code de hachage de cette instance.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsDefaultAttribute()	Retourne une valeur qui indique s'il s'agit de l'instance DescriptionAttribute par défaut.
Match(Object)	En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• Attribute
• PropertyDescriptor
• EventDescriptor