CategoryAttribute Classe

Definizione

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

Ereditarietà

Object

Attribute

CategoryAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio seguente viene creata la MyImage proprietà . La proprietà ha due attributi: a DescriptionAttribute e 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'esempio successivo ottiene la categoria per MyImage. Prima di tutto, il codice ottiene un PropertyDescriptorCollection con tutte le proprietà per l'oggetto. Successivamente, gli indici di codice nell'oggetto PropertyDescriptorCollection per ottenere MyImage. Restituisce quindi gli attributi per questa proprietà e li salva nella variabile attributes.

L'esempio stampa quindi la categoria recuperando CategoryAttribute dall'oggetto AttributeCollectione scrivendola nella schermata della 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)

Commenti

Indica CategoryAttribute la categoria da associare alla proprietà o all'evento associato, quando si elencano proprietà o eventi in un PropertyGrid controllo impostato su Categorized modalità. Se un oggetto CategoryAttribute non è stato applicato a una proprietà o a un evento, lo PropertyGrid associa alla categoria Misc . È possibile creare una nuova categoria per qualsiasi nome specificando il nome della categoria nel costruttore per CategoryAttribute.

La Category proprietà indica il nome della categoria rappresentata dall'attributo. La Category proprietà fornisce anche la localizzazione trasparente dei nomi di categoria.

Note per gli eredi

Se si usano nomi di categoria diversi dai nomi predefiniti e si desidera localizzare i nomi delle categorie, è necessario eseguire l'override del GetLocalizedString(String) metodo.

La CategoryAttribute classe definisce le categorie comuni seguenti:

Per altre informazioni, vedere Attributi.

Costruttori

Proprietà

Metodi

Implementazioni dell'interfaccia esplicita

Si applica a

Vedi anche

• Attribute
• PropertyDescriptor
• EventDescriptor