Freigeben über

Attribute in Windows Forms-Steuerelementen

  • Artikel

Das .NET Framework bietet eine Vielzahl von Attributen, die Sie auf die Member der benutzerdefinierten Steuerelemente und Komponenten anwenden können. Einige dieser Attribute haben Auswirkungen auf das Laufzeitverhalten einer Klasse, während andere Auswirkungen auf das Entwurfszeitverhalten haben.

Achtung

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 Designer-System für Windows Forms hat sich geändert, und es ist wichtig, dass Sie den Artikel Änderungen am Designer seit .NET Framework lesen.

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.

attribute BESCHREIBUNG
AmbientValueAttribute Gibt den Wert an, der an eine Eigenschaft übergeben werden soll, damit die Eigenschaft den zugehörigen Wert von 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 akzeptiert.
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 von 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 sollte, wenn sich der zugehörige Eigenschaftswert ändert.
TypeConverterAttribute Gibt an, welcher Typ als Konverter für das Objekt verwendet werden sollte, an das dieses Attribut gebunden ist.

Attribute für Datenbindungseigenschaften

In der folgenden Tabelle werden die Attribute angezeigt, die Sie für die Angabe anwenden können, wie Ihre benutzerdefinierten Steuerelemente und Komponenten mit der Datenbindung interagieren.

attribute BESCHREIBUNG
BindableAttribute Gibt an, ob eine Eigenschaft in der Regel für die Bindung verwendet wird.
ComplexBindingPropertiesAttribute Gibt die Eigenschaften der Datenquelle und des Datenmembers für eine Komponente an.
DefaultBindingPropertyAttribute Gibt die Standardbindungseigenschaft für eine Komponente an.
LookupBindingPropertiesAttribute Gibt die Eigenschaften der Datenquelle und des Datenmembers für eine Komponente an.
AttributeProviderAttribute Ermöglicht die Umleitung von Attributen.

Attribute für Klassen

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

attribute 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, die für ein Werkzeugkastenelement verwendet werden sollen.

Weitere Informationen