CategoryAttribute Klasse

Definition

Namespace:

System.ComponentModel

Assemblys:

netstandard.dll, System.ComponentModel.Primitives.dll

Quelle:

CategoryAttribute.cs

Gibt den Namen der Kategorie an, in der die Eigenschaft oder das Ereignis gruppiert werden soll, wenn sie in einem PropertyGrid Steuerelement, das auf den Kategorisierten Modus festgelegt ist, angezeigt wird.

public ref class CategoryAttribute : Attribute

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

[<System.AttributeUsage(System.AttributeTargets.All)>]
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:

Category	Beschreibung
Action	Eigenschaften im Zusammenhang mit verfügbaren Aktionen.
Appearance	Eigenschaften im Zusammenhang mit der Darstellung einer Entität.
Behavior	Eigenschaften im Zusammenhang mit der Funktionsweise einer Entität.
Data	Eigenschaften im Zusammenhang mit der Daten- und Datenquellenverwaltung.
Default	Eigenschaften, die in einer Standardkategorie gruppiert sind.
Design	Eigenschaften, die nur zur Entwurfszeit verfügbar sind.
DragDrop	Eigenschaften im Zusammenhang mit Drag-and-Drop-Vorgängen.
Focus	Eigenschaften im Zusammenhang mit dem Fokus.
Format	Eigenschaften im Zusammenhang mit der Formatierung.
Key	Eigenschaften im Zusammenhang mit der Tastatur.
Layout	Eigenschaften im Zusammenhang mit dem Layout.
Mouse	Eigenschaften im Zusammenhang mit der Maus.
WindowStyle	Eigenschaften im Zusammenhang mit dem Fensterstil von Formularen auf oberster Ebene.

Weitere Informationen finden Sie unter Attribute.

Konstruktoren

Name	Beschreibung
CategoryAttribute()	Initialisiert eine neue Instanz der CategoryAttribute Klasse mit dem Kategorienamen Default.
CategoryAttribute(String)	Initialisiert eine neue Instanz der CategoryAttribute Klasse mithilfe des angegebenen Kategorienamens.

Eigenschaften

Name	Beschreibung
Action	Ruft eine CategoryAttribute Darstellung der Aktionskategorie ab.
Appearance	Ruft eine CategoryAttribute Darstellungskategorie ab.
Asynchronous	Ruft eine CategoryAttribute Darstellung der asynchronen Kategorie ab.
Behavior	Ruft eine CategoryAttribute Darstellung der Verhaltenskategorie ab.
Category	Ruft den Namen der Kategorie für die Eigenschaft oder das Ereignis ab, auf die dieses Attribut angewendet wird.
Data	Ruft eine CategoryAttribute Darstellung der Datenkategorie ab.
Default	Ruft eine CategoryAttribute Darstellung der Standardkategorie ab.
Design	Ruft eine CategoryAttribute Darstellung der Designkategorie ab.
DragDrop	Ruft eine CategoryAttribute Darstellung der DragDrop-Kategorie ab.
Focus	Ruft eine CategoryAttribute Darstellung der Fokuskategorie ab.
Format	Ruft eine CategoryAttribute Darstellung der Formatkategorie ab.
Key	Ruft eine CategoryAttribute Darstellung der Schlüsselkategorie ab.
Layout	Ruft eine CategoryAttribute Darstellung der Layoutkategorie ab.
Mouse	Ruft eine CategoryAttribute Darstellung der Mauskategorie ab.
TypeId	Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute. (Geerbt von Attribute)
WindowStyle	Ruft eine CategoryAttribute Darstellung der WindowStyle-Kategorie ab.

Methoden

Name	Beschreibung
Equals(Object)	Gibt zurück, ob der Wert des angegebenen Objekts dem aktuellen CategoryAttributeentspricht.
GetHashCode()	Gibt den Hashcode für dieses Attribut zurück.
GetLocalizedString(String)	Sucht den lokalisierten Namen der angegebenen Kategorie.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
IsDefaultAttribute()	Bestimmt, ob dieses Attribut die Standardeinstellung ist.
Match(Object)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• Attribute
• PropertyDescriptor
• EventDescriptor