AttributeProviderAttribute Classe

Definição

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

Herança

Object

Attribute

AttributeProviderAttribute

Atributos

AttributeUsageAttribute

Exemplos

O exemplo de código seguinte demonstra a utilização AttributeProviderAttribute de marcar uma DataSource propriedade com um tipo específico de IListSource. Para uma listagem completa do código, veja Como: Aplicar Atributos em Controlos Windows Forms.

[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

Observações

Existem alguns casos no modelo de objetos .NET Framework em que uma propriedade é propositadamente tipada para ser vaga. Por exemplo, a DataGridView.DataSource propriedade é tipada como object. A razão para isto é que esta propriedade pode aceitar vários tipos de entrada. Infelizmente, isto não oferece um local comum para adicionar metadados que descrevam as características da propriedade. Cada propriedade DataSource ao longo do .NET Framework precisa de ter metadados idênticos para conversores de tipos, editores de tipos UI e outros serviços que exijam metadados. A solução AttributeProviderAttribute resolve esta situação.

Uma vez que este atributo é colocado numa propriedade, as regras para obter atributos para a coleção do MemberDescriptor.Attributes descritor de propriedade diferem. Normalmente, o descritor de propriedade recolhe atributos locais e depois funde-os com atributos do tipo de propriedade. Neste caso, os atributos são retirados do tipo devolvido do AttributeProviderAttribute, e não do tipo de propriedade real. Este atributo é usado para DataGridView.DataSource apontar o DataGridView.DataSource tipo específico do objeto para IListSource, e os metadados apropriados são colocados para IListSource permitir a ligação de dados. Ao fazê-lo, partes externas podem facilmente adicionar metadados a todas as fontes de dados.

Os atributos obtidos de um tipo declarado em têm AttributeProviderAttribute uma prioridade entre os atributos do tipo da propriedade e os atributos da propriedade. A lista seguinte, por ordem de prioridade, mostra o conjunto completo de atributos fundidos disponíveis:

• Atributos da Propriedade

• Atributos do Fornecedor de Atributos

• Atributos de Tipo de Propriedade

Ver também

• TypeDescriptor
• Visão Geral do Descritor de Tipo