Freigeben über

Attribute in Windows Forms-Steuerelementen

Das .NET Framework bietet eine Vielzahl von Attributen, die Sie auf die Mitglieder Ihrer benutzerdefinierten Steuerelemente und Komponenten anwenden können. Einige dieser Attribute wirken sich auf das Laufzeitverhalten einer Klasse aus, andere wirken sich auf das Entwurfszeitverhalten aus.

Vorsicht

Dieser Inhalt wurde für .NET Framework geschrieben. Wenn Sie .NET 6 oder eine höhere Version verwenden, verwenden Sie diesen Inhalt mit Vorsicht. Das Designersystem hat sich für Windows Forms geändert, und es ist wichtig, dass Sie die Änderungen im Designer seit dem .NET Framework Artikel überprüfen.

Attribute für Steuerelement- und Komponenteneigenschaften

Die folgende Tabelle enthält die Attribute, die Sie auf Eigenschaften oder andere Member der benutzerdefinierten Steuerelemente und Komponenten anwenden können. Ein Beispiel, in dem viele dieser Attribute verwendet werden, finden Sie unter Vorgehensweise: Anwenden von Attributen auf Windows Forms-Steuerelemente.

Merkmal BESCHREIBUNG
AmbientValueAttribute Gibt den Wert an, der an eine Eigenschaft übergeben werden soll, damit die Eigenschaft ihren Wert aus einer anderen Quelle abrufen kann. Dies wird als Umgebung bezeichnet.
BrowsableAttribute Gibt an, ob eine Eigenschaft oder ein Ereignis im Fenster Eigenschaften angezeigt werden soll.
CategoryAttribute Gibt den Namen der Kategorie an, in der die Eigenschaft oder das Ereignis bei der Anzeige in einem PropertyGrid-Steuerelement gruppiert werden soll, das auf den Modus Categorized festgelegt ist.
DefaultValueAttribute Gibt den Standardwert für eine Eigenschaft an.
DescriptionAttribute Gibt die Beschreibung einer Eigenschaft oder eines Ereignisses an.
DisplayNameAttribute Gibt den Anzeigenamen für eine Eigenschaft, ein Ereignis oder eine public void Methode an, die keine Argumente benötigt.
EditorAttribute Gibt den Editor an, der zum Ändern einer Eigenschaft verwendet wird.
EditorBrowsableAttribute Gibt an, dass eine Eigenschaft oder Methode in einem Editor angezeigt werden kann.
HelpKeywordAttribute Gibt das Kontextschlüsselwort für eine Klasse oder ein Element an.
LocalizableAttribute Gibt an, ob eine Eigenschaft lokalisiert werden soll.
PasswordPropertyTextAttribute Gibt an, dass die Textdarstellung eines Objekts durch Zeichen wie Sternchen verdeckt wird.
ReadOnlyAttribute Gibt an, ob die Eigenschaft, an die dieses Attribut gebunden ist, schreibgeschützt ist oder ob zur Entwurfszeit Lese-/Schreibzugriff gewährt wird.
RefreshPropertiesAttribute Gibt an, dass das Eigenschaftenraster aktualisiert werden soll, wenn sich der zugeordnete Eigenschaftswert ändert.
TypeConverterAttribute Wird angegeben, welcher Typ als Konverter für das Objekt verwendet wird, an das dieses Attribut gebunden ist.

Attribute für Datenbindungseigenschaften

In der folgenden Tabelle sind die Attribute aufgeführt, die Sie anwenden können, um anzugeben, wie Ihre benutzerdefinierten Steuerelemente und Komponenten mit der Datenbindung interagieren.

Merkmal BESCHREIBUNG
BindableAttribute Gibt an, ob eine Eigenschaft in der Regel für die Bindung verwendet wird.
ComplexBindingPropertiesAttribute Gibt die Datenquellen- und Datenelementeigenschaften für eine Komponente an.
DefaultBindingPropertyAttribute Gibt die Standardbindungseigenschaft für eine Komponente an.
LookupBindingPropertiesAttribute Gibt die Datenquellen- und Datenelementeigenschaften für eine Komponente an.
AttributeProviderAttribute Ermöglicht die Umleitung von Attributen.

Attribute für Klassen

In der folgenden Tabelle sind die Attribute aufgeführt, die Sie anwenden können, um das Verhalten Ihrer benutzerdefinierten Steuerelemente und Komponenten zur Entwurfszeit anzugeben.

Merkmal BESCHREIBUNG
DefaultEventAttribute Gibt das Standardereignis für eine Komponente an.
DefaultPropertyAttribute Gibt die Standardeigenschaft für eine Komponente an.
DesignerAttribute Gibt die Klasse an, die zum Implementieren von Entwurfszeitdiensten für eine Komponente verwendet wird.
DesignerCategoryAttribute Gibt an, dass der Designer für eine Klasse zu einer bestimmten Kategorie gehört.
ToolboxItemAttribute Stellt ein Attribut eines Werkzeugkastenelements dar.
ToolboxItemFilterAttribute Gibt die Filterzeichenfolge und den Filtertyp an, der für ein Toolboxelement verwendet werden soll.

Siehe auch

  • Last updated on