CategoryAttribute Klasse

Definition

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

Vererbung

Object

Attribute

CategoryAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird die MyImage Eigenschaft erstellt. Die Eigenschaft verfügt über zwei Attribute: a DescriptionAttribute und a 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

Im nächsten Beispiel wird die Kategorie für MyImage. Zuerst ruft der Code eine PropertyDescriptorCollection mit allen Eigenschaften für das Objekt ab. Als Nächstes wird der Code indiziert PropertyDescriptorCollection , um abzurufen MyImage. Anschließend werden die Attribute für diese Eigenschaft zurückgegeben und in der Variablen attributesgespeichert.

Das Beispiel druckt dann die Kategorie, indem sie aus dem AttributeCollectionKonsolenbildschirm abgerufen CategoryAttribute und in den Konsolenbildschirm geschrieben wird.

// 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)

Hinweise

A CategoryAttribute gibt die Kategorie an, der die zugeordnete Eigenschaft oder das zugehörige Ereignis zugeordnet werden soll, wenn Eigenschaften oder Ereignisse in einem PropertyGrid Steuerelement aufgelistet werden, das auf den Categorized Modus festgelegt ist. Wenn ein Objekt CategoryAttribute nicht auf eine Eigenschaft oder ein Ereignis angewendet wurde, ordnet es der PropertyGrid Kategorie "Sonstiges " zu. Eine neue Kategorie kann für jeden Namen erstellt werden, indem sie den Namen der Kategorie im Konstruktor für die CategoryAttribute.

Die Category Eigenschaft gibt den Namen der Kategorie an, die das Attribut darstellt. Die Category Eigenschaft bietet auch eine transparente Lokalisierung von Kategorienamen.

Hinweise für Vererber

Wenn Sie andere Kategorienamen als die vordefinierten Namen verwenden und Die Kategorienamen lokalisieren möchten, müssen Sie die GetLocalizedString(String) Methode außer Kraft setzen.

Die CategoryAttribute Klasse definiert die folgenden allgemeinen Kategorien:

Weitere Informationen finden Sie unter Attribute.

Weitere Informationen

• Attribute
• PropertyDescriptor
• EventDescriptor