Attributs (Guide de programmation C#)

Mise à jour : Juillet 2008

Les attributs fournissent une méthode puissante pour associer des informations de déclaration au code C# (types, méthodes, propriétés, etc.). Une fois qu'il est associé à une entité de programme, l'attribut peut être interrogé au moment de l'exécution au moyen d'une technique appelée réflexion. Pour plus d'informations, consultez Réflexion (Guide de programmation C#).

Les attributs existent sous deux formes :

• les attributs qui sont définis dans CLR (Common Language Runtime).

• les attributs personnalisés que vous pouvez créer, pour ajouter des informations supplémentaires à votre code. Ces informations peuvent être récupérées ultérieurement par programme.

Dans cet exemple, l'attribut TypeAttributes.Serializable est utilisé pour appliquer une caractéristique spécifique à une classe :

[System.Serializable]
public class SampleClass
{
    // Objects of this type can be serialized.
}

Vue d'ensemble des attributs

Les attributs ont les propriétés suivantes :

• Les attributs ajoutent des métadonnées à votre programme. Les métadonnées sont des informations sur les types définis dans un programme. Tous les assemblys .NET contiennent un jeu spécifique de métadonnées qui décrivent les types et les membres de type définis dans l'assembly. Vous pouvez ajouter des attributs personnalisés pour spécifier toutes les informations supplémentaires nécessaires.

• Votre programme peut examiner ses propres métadonnées ou celles dans d'autres programmes au moyen de la réflexion. Pour plus d'informations, consultez Accès à des attributs à l'aide de la réflexion (Guide de programmation C#).

• Les attributs comme MarshallAs sont extrêmement employés dans les scénarios COM Interop. Pour plus d'informations, consultez System.Runtime.InteropServices.MarshalAsAttribute et System.Runtime.InteropServices.StructLayoutAttribute.

Rubriques connexes

Pour plus d'informations, consultez :

• Utilisation d'attributs (Guide de programmation C#)

• Création d'attributs personnalisés (Guide de programmation C#)

• Levée de l'ambiguïté sur les cibles d'attribut (Guide de programmation C#)

• Accès à des attributs à l'aide de la réflexion (Guide de programmation C#)

• Comment : créer une union C/C++ à l'aide d'attributs (Guide de programmation C#)

• Attributs communs (Guide de programmation C#)

• Attributs, exemple

Spécifications du langage C#

Pour plus d'informations, consultez les sections suivantes dans Spécifications du langage C#.

• 10.2.1 Attributs

• 17 Attributs

Voir aussi

Concepts

Guide de programmation C#

Vue d'ensemble des attributs

Utilisations courantes des attributs

Référence

Réflexion (Guide de programmation C#)

Historique des modifications