AttributeProviderAttribute AttributeProviderAttribute AttributeProviderAttribute AttributeProviderAttribute Class

Définition

Active la redirection d’attribut.Enables attribute redirection. Cette classe ne peut pas être héritée.This class cannot be inherited.

public ref class AttributeProviderAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Property)]
public class AttributeProviderAttribute : Attribute
type AttributeProviderAttribute = class
    inherit Attribute
Public Class AttributeProviderAttribute
Inherits Attribute
Héritage
AttributeProviderAttributeAttributeProviderAttributeAttributeProviderAttributeAttributeProviderAttribute
Attributs

Exemples

L’exemple de code suivant illustre AttributeProviderAttribute l’utilisation de DataSource pour marquer une propriété avec un IListSourcetype spécifique de.The following code example demonstrates using AttributeProviderAttribute to mark a DataSource property with a specific type of IListSource. Pour obtenir une liste complète du code , consultez Procédure: Appliquez des attributs dans lescontrôles Windows Forms.For a full code listing, see How to: Apply Attributes in Windows Forms Controls.

[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 dans lequel une propriété est intentionnellement typée pour être vague.There are a few cases in the .NET Framework object model where a property is purposely typed to be vague. Par exemple, la DataGridView.DataSource propriété est de objecttype.For example, the DataGridView.DataSource property is typed as object. Cela est dû au fait que cette propriété peut accepter plusieurs types d’entrée.The reason for this is that this property can accept several types of input. Malheureusement, cela ne fournit aucun emplacement commun pour ajouter des métadonnées afin de décrire les caractéristiques de la propriété.Unfortunately, this provides no common place to add metadata to describe the characteristics of the property. Chaque DataSource propriété de l' .NET Framework doit avoir des métadonnées identiques pour les convertisseurs de type, les éditeurs de type d’interface utilisateur et d’autres services qui requièrent des métadonnées.Each DataSource property throughout the .NET Framework needs to have identical metadata for type converters, UI type editors, and other services that require metadata. Le AttributeProviderAttribute fait de remédier à cette situation.The AttributeProviderAttribute remedies this situation.

Une fois que cet attribut est placé sur une propriété, les règles d’obtention des attributs de la MemberDescriptor.Attributes collection du descripteur de propriété diffèrent.Once this attribute is placed on a property, the rules for obtaining attributes for the property descriptor's MemberDescriptor.Attributes collection differ. En règle générale, le descripteur de propriété recueille des attributs locaux, puis les fusionne avec des attributs du type de propriété.Typically, the property descriptor gathers local attributes, and then merges these with attributes from the property type. Dans ce cas, les attributs sont extraits du type retourné par AttributeProviderAttribute, et non du type de propriété réel.In this case, the attributes are taken from the type returned from the AttributeProviderAttribute, not from the actual property type. Cet attribut est utilisé sur DataGridView.DataSource pour pointer DataGridView.DataSource le type spécifique de l' IListSourceobjet vers IListSource , et les métadonnées appropriées sont mises en place pour activer la liaison de données.This attribute is used on DataGridView.DataSource to point the DataGridView.DataSource object's specific type to IListSource, and the appropriate metadata is placed on IListSource to enable data binding. Dans ce cas, les parties externes peuvent facilement ajouter des métadonnées à toutes les sources de données.In so doing, external parties can easily add metadata to all data sources.

Les attributs obtenus à partir d’un type AttributeProviderAttribute déclaré dans le ont une priorité entre les attributs du type de la propriété et les attributs sur la propriété.Attributes obtained from a type declared in the AttributeProviderAttribute have a priority in between the attributes of the property's type and the attributes on the property. La liste suivante, par ordre de priorité, montre l’ensemble complet des attributs fusionnés disponibles:The following list, in priority order, shows the full set of available merged attributes:

  • Attributs de propriétéProperty Attributes

  • Attributs du fournisseur d’attributsAttribute Provider Attributes

  • Attributs de type de propriétéProperty Type Attributes

Constructeurs

AttributeProviderAttribute(String) AttributeProviderAttribute(String) AttributeProviderAttribute(String) AttributeProviderAttribute(String)

Initialise une nouvelle instance de la classe AttributeProviderAttribute à l'aide du nom de type donné.Initializes a new instance of the AttributeProviderAttribute class with the given type name.

AttributeProviderAttribute(String, String) AttributeProviderAttribute(String, String) AttributeProviderAttribute(String, String) AttributeProviderAttribute(String, String)

Initialise une nouvelle instance de la classe AttributeProviderAttribute avec le nom de type et le nom de propriété donnés.Initializes a new instance of the AttributeProviderAttribute class with the given type name and property name.

AttributeProviderAttribute(Type) AttributeProviderAttribute(Type) AttributeProviderAttribute(Type) AttributeProviderAttribute(Type)

Initialise une nouvelle instance de la classe AttributeProviderAttribute à l'aide du type donné.Initializes a new instance of the AttributeProviderAttribute class with the given type.

Propriétés

PropertyName PropertyName PropertyName PropertyName

Obtient le nom de la propriété pour laquelle les attributs seront récupérés.Gets the name of the property for which attributes will be retrieved.

TypeId TypeId TypeId TypeId

Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)
TypeName TypeName TypeName TypeName

Obtient le nom de type qualifié de l'assembly passé dans le constructeur.Gets the assembly qualified type name passed into the constructor.

Méthodes

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Retourne une valeur qui indique si cette instance est égale à un objet spécifié.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Retourne le code de hachage de cette instance.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Implémentations d’interfaces explicites

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fournit l'accès aux propriétés et aux méthodes exposées par un objet.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

S’applique à

Voir aussi