AttributeProviderAttribute Classe

Definizione

public ref class AttributeProviderAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Property)]
public class AttributeProviderAttribute : Attribute

public class AttributeProviderAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Property)>]
type AttributeProviderAttribute = class
    inherit Attribute

type AttributeProviderAttribute = class
    inherit Attribute

Public Class AttributeProviderAttribute
Inherits Attribute

Ereditarietà

Object

Attribute

AttributeProviderAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio di codice seguente viene illustrato l'uso AttributeProviderAttribute di per contrassegnare una DataSource proprietà con un tipo specifico di IListSource. Per un elenco di codice completo, vedere Procedura: Applicare attributi nei controlli Windows Form.

[Category("Data")]
[Description("Indicates the source of data for the control.")]
[RefreshProperties(RefreshProperties.Repaint)]
[AttributeProvider(typeof(IListSource))]
public object DataSource
{
    get => _dataGridView1.DataSource;
    set => _dataGridView1.DataSource = value;
}

<Category("Data"), _
Description("Indicates the source of data for the control."), _
RefreshProperties(RefreshProperties.Repaint), _
AttributeProvider(GetType(IListSource))> _
Public Property DataSource() As Object
    Get
        Return Me.dataGridView1.DataSource
    End Get

    Set(ByVal value As Object)
        Me.dataGridView1.DataSource = value
    End Set
End Property

Commenti

Esistono alcuni casi nel modello a oggetti di .NET Framework in cui una proprietà è tipizzata per essere vaga. Ad esempio, la DataGridView.DataSource proprietà viene tipizzata come object. Il motivo è che questa proprietà può accettare diversi tipi di input. Sfortunatamente, questo non fornisce un luogo comune per aggiungere metadati per descrivere le caratteristiche della proprietà. Ogni DataSource proprietà in .NET Framework deve avere metadati identici per convertitori di tipi, editor dei tipi di interfaccia utente e altri servizi che richiedono metadati. Il AttributeProviderAttribute rimedio di questa situazione.

Dopo che questo attributo viene inserito in una proprietà, le regole per ottenere gli attributi per la raccolta del descrittore di MemberDescriptor.Attributes proprietà differiscono. In genere, il descrittore della proprietà raccoglie gli attributi locali e quindi unisce questi attributi con gli attributi del tipo di proprietà. In questo caso, gli attributi vengono ricavati dal tipo restituito da AttributeProviderAttribute, non dal tipo di proprietà effettivo. Questo attributo viene usato per DataGridView.DataSource puntare il DataGridView.DataSource tipo specifico dell'oggetto a IListSourcee i metadati appropriati vengono inseriti per IListSource abilitare il data binding. In questo modo, le parti esterne possono aggiungere facilmente metadati a tutte le origini dati.

Gli attributi ottenuti da un tipo dichiarato in AttributeProviderAttribute hanno una priorità tra gli attributi del tipo della proprietà e gli attributi della proprietà. L'elenco seguente, in ordine di priorità, mostra il set completo di attributi uniti disponibili:

• Attributi delle proprietà

• Attributi del provider di attributi

• Attributi del tipo di proprietà

Vedi anche

• TypeDescriptor
• Panoramica del descrittore di tipi