CategoryAttribute-Klasse

Ein CategoryAttribute gibt die Kategorie an, der die zugeordnete Eigenschaft oder das zugeordnete Ereignis zugeordnet werden soll, wenn Eigenschaften oder Ereignisse in einem PropertyGrid-Steuerelement aufgelistet werden, das auf den Modus Categorized festgelegt ist. Wenn ein CategoryAttribute nicht auf eine Eigenschaft oder ein Ereignis angewendet wurde, wird es von PropertyGrid der Kategorie Sonstiges zugeordnet. Für jeden Namen kann eine neue Kategorie erstellt werden, indem Sie den Namen der Kategorie im Konstruktor für das CategoryAttribute angeben.

Die Category-Eigenschaft gibt den Namen der Kategorie an, die das Attribut darstellt. Die Category-Eigenschaft ermöglicht außerdem eine transparente Lokalisierung von Kategorienamen.

Wenn Sie andere Kategorienamen als die vordefinierten verwenden und die Kategorienamen lokalisieren möchten, müssen Sie die GetLocalizedString-Methode überschreiben.

Die CategoryAttribute-Klasse definiert die folgenden allgemeinen Kategorien:

Weitere Informationen finden Sie unter Erweitern von Metadaten mithilfe von Attributen.

Im folgenden Beispiel wird die MyImage-Eigenschaft erstellt. Die Eigenschaft verfügt über zwei Attribute: DescriptionAttribute und CategoryAttribute.

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

Im nächsten Beispiel wird die Kategorie für MyImage abgerufen. Zunächst wird im Code eine PropertyDescriptorCollection mit allen Eigenschaften für das Objekt abgerufen. Anschließend wird im Code MyImage über einen Index der PropertyDescriptorCollection abgerufen. Die Attribute für diese Eigenschaft werden zurückgegeben und in der Variablen attributes gespeichert.

Im Beispiel erfolgt dann die Ausgabe der Kategorie auf dem Konsolenbildschirm, indem CategoryAttribute aus AttributeCollection abgerufen 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 = 
    (CategoryAttribute)attributes[typeof(CategoryAttribute)];
 Console.WriteLine(myAttribute.Category);

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz