AttributeProviderAttribute Classe

Définition

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

Héritage

Object

Attribute

AttributeProviderAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple de code suivant illustre l’utilisation AttributeProviderAttribute de pour marquer une DataSource propriété avec un type spécifique de IListSource. Pour obtenir la liste complète du code, consultez Guide pratique pour appliquer des attributs dans les contrôles Windows Forms.

[Category("Data")]
[Description("Indicates the source of data for the control.")]
[RefreshProperties(RefreshProperties.Repaint)]
[AttributeProvider(typeof(IListSource))]
public object DataSource
{
    get
    {
        return this.dataGridView1.DataSource;
    }

    set
    {
        this.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

Remarques

Il existe quelques cas dans le modèle objet .NET Framework où une propriété est volontairement typée pour être vague. Par exemple, la DataGridView.DataSource propriété est typée en tant que object. La raison en est que cette propriété peut accepter plusieurs types d’entrée. Malheureusement, cela ne fournit pas d’emplacement commun pour ajouter des métadonnées pour décrire les caractéristiques de la propriété. Chaque DataSource propriété du .NET Framework doit avoir des métadonnées identiques pour les convertisseurs de types, les éditeurs de types d’interface utilisateur et d’autres services qui nécessitent des métadonnées. Les AttributeProviderAttribute remèdes à cette situation.

Une fois cet attribut placé sur une propriété, les règles d’obtention des attributs pour la collection du descripteur de MemberDescriptor.Attributes propriété diffèrent. En règle générale, le descripteur de propriété collecte les attributs locaux, puis les fusionne avec les attributs du type de propriété. Dans ce cas, les attributs sont extraits du type retourné à partir de , AttributeProviderAttributeet non du type de propriété réel. Cet attribut est utilisé sur DataGridView.DataSource pour pointer le type spécifique de l’objet DataGridView.DataSource vers IListSource, et les métadonnées appropriées sont placées sur IListSource pour activer la liaison de données. Ce faisant, les parties externes peuvent facilement ajouter des métadonnées à toutes les sources de données.

Les attributs obtenus à partir d’un type déclaré dans ont AttributeProviderAttribute une priorité entre les attributs du type de la propriété et les attributs de la propriété. La liste suivante, dans l’ordre de priorité, affiche l’ensemble complet des attributs fusionnés disponibles :

• Attributs de propriété

• Attributs du fournisseur d’attributs

• Attributs de type de propriété

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à

Voir aussi

• TypeDescriptor
• Vue d'ensemble du descripteur de type