Condividi tramite


Attributi nei controlli di Windows Forms

.NET Framework offre un'ampia gamma di attributi che è possibile applicare ai membri dei controlli e dei componenti personalizzati. Alcuni di questi attributi influiscono sul comportamento di runtime di una classe e altri influiscono sul comportamento della fase di progettazione.

Attenzione

Questo contenuto è stato scritto per .NET Framework. Se si usa .NET 6 o una versione successiva, usare questo contenuto con cautela. Il sistema di progettazione è stato modificato per Windows Form ed è importante esaminare le modifiche apportate alla finestra di progettazione dall'articolo .NET Framework.

Attributi delle proprietà di controllo e componente

La tabella seguente illustra gli attributi che è possibile applicare alle proprietà o ad altri membri dei controlli e dei componenti personalizzati. Per un esempio che usa molti di questi attributi, vedere Procedura: Applicare attributi nei controlli Windows Form.

Attributo Descrizione
AmbientValueAttribute Specifica il valore da passare a una proprietà per fare in modo che la proprietà ottenga il relativo valore da un'altra origine. Questo è noto come ambiente .
BrowsableAttribute Specifica se una proprietà o un evento deve essere visualizzato in una finestra Proprietà.
CategoryAttribute Specifica il nome della categoria in cui raggruppare la proprietà o l'evento quando è visualizzato in un controllo PropertyGrid impostato in modalità Categorized.
DefaultValueAttribute Specifica il valore predefinito per una proprietà.
DescriptionAttribute Specifica una descrizione per una proprietà o un evento.
DisplayNameAttribute Specifica il nome visualizzato per una proprietà, un evento o un metodo public void che non accetta argomenti.
EditorAttribute Specifica l'editor da utilizzare per modificare una proprietà.
EditorBrowsableAttribute Specifica che una proprietà o un metodo è visualizzabile in un editor.
HelpKeywordAttribute Specifica la parola chiave "context" per una classe o un membro.
LocalizableAttribute Specifica se una proprietà deve essere localizzata.
PasswordPropertyTextAttribute Indica che la rappresentazione di testo di un oggetto è nascosta da caratteri quali asterischi.
ReadOnlyAttribute Specifica se la proprietà a cui è associato questo attributo è di sola lettura o di lettura/scrittura in fase di progettazione.
RefreshPropertiesAttribute Indica che la griglia delle proprietà deve essere aggiornata quando viene modificato il valore della proprietà associato.
TypeConverterAttribute Specifica il tipo da utilizzare come convertitore per l'oggetto a cui è associato questo attributo.

Attributi per le proprietà di Data Binding

La tabella seguente illustra gli attributi che è possibile applicare per specificare il modo in cui i controlli personalizzati e i componenti interagiscono con il data binding.

Attributo Descrizione
BindableAttribute Specifica se una proprietà viene in genere utilizzata per il binding.
ComplexBindingPropertiesAttribute Specifica le proprietà della fonte dati e del membro dati per un componente.
DefaultBindingPropertyAttribute Specifica la proprietà di associazione predefinita per un componente.
LookupBindingPropertiesAttribute Specifica le proprietà della fonte dati e del membro dati per un componente.
AttributeProviderAttribute Abilita il reindirizzamento degli attributi.

Attributi per le classi

La tabella seguente illustra gli attributi che è possibile applicare per specificare il comportamento dei controlli e dei componenti personalizzati in fase di progettazione.

Attributo Descrizione
DefaultEventAttribute Specifica l'evento predefinito per un componente.
DefaultPropertyAttribute Specifica la proprietà predefinita per un componente.
DesignerAttribute Specifica la classe utilizzata per implementare servizi in fase di progettazione per un componente.
DesignerCategoryAttribute Specifica che il progettista di una classe appartiene a una determinata categoria.
ToolboxItemAttribute Rappresenta un attributo di un elemento della casella degli strumenti.
ToolboxItemFilterAttribute Specifica la stringa di filtro e il tipo di filtro da utilizzare per un elemento della casella degli strumenti.

Vedere anche