CategoryAttribute Classe

Définition

public ref class CategoryAttribute : Attribute

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

public class CategoryAttribute : Attribute

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

type CategoryAttribute = class
    inherit Attribute

Public Class CategoryAttribute
Inherits Attribute

Héritage

Object

Attribute

CategoryAttribute

Attributs

AttributeUsageAttribute

Exemples

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

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

   void set( System::Drawing::Image^ )
   {
      // 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 catégorie pour MyImage. Tout d’abord, le code obtient un PropertyDescriptorCollection avec toutes les propriétés de l’objet. Ensuite, le code s’indexe dans pour PropertyDescriptorCollection obtenir MyImage. Ensuite, il retourne les attributs de cette propriété et les enregistre dans la variable attributes.

L’exemple imprime ensuite la catégorie en récupérant à partir de et AttributeCollectionen l’écrivant CategoryAttribute 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 CategoryAttribute.
// from the AttributeCollection.
CategoryAttribute^ myAttribute = static_cast<CategoryAttribute^>(attributes[ CategoryAttribute::typeid ]);
Console::WriteLine( myAttribute->Category );

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

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

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

Remarques

Un CategoryAttribute indique la catégorie à laquelle associer la propriété ou l’événement associé, lors de la liste des propriétés ou des événements dans un PropertyGrid contrôle défini sur Categorized mode. Si un CategoryAttribute n’a pas été appliqué à une propriété ou à un événement, l’associe PropertyGrid à la catégorie Misc . Vous pouvez créer une nouvelle catégorie pour n’importe quel nom en spécifiant le nom de la catégorie dans le constructeur pour .CategoryAttribute

La Category propriété indique le nom de la catégorie que l’attribut représente. La Category propriété fournit également une localisation transparente des noms de catégorie.

Notes pour les héritiers

Si vous utilisez des noms de catégorie autres que les noms prédéfinis et que vous souhaitez localiser vos noms de catégorie, vous devez remplacer la GetLocalizedString(String) méthode.

La CategoryAttribute classe définit les catégories courantes suivantes :

Pour plus d’informations, consultez Attributs.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• Attribute
• PropertyDescriptor
• EventDescriptor