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 .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.
        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

Nell'esempio seguente viene recuperata la categoria per MyImage. Innanzitutto, il codice ottiene un PropertyDescriptorCollection oggetto con tutte le proprietà per l'oggetto . Successivamente, il codice indicizza in PropertyDescriptorCollection per ottenere MyImage. Restituisce quindi gli attributi per questa proprietà e li salva nella variabile attributes.

Nell'esempio viene quindi stampata la categoria recuperando CategoryAttribute da 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

Un CategoryAttribute valore indica la categoria a cui associare la proprietà o l'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, PropertyGrid lo 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.

Vedi anche

• Attribute
• PropertyDescriptor
• EventDescriptor