Attributs personnalisés en Visual Basic

Mise à jour : novembre 2007

Les attributs personnalisés sont des attributs définis par l'utilisateur qui fournissent des informations supplémentaires au sujet d'éléments de programme. Vous pouvez, par exemple, définir un attribut de sécurité personnalisé qui détermine les autorisations requises par l'appelant afin d'exécuter une procédure.

Les attributs personnalisés sont définis dans des classes d'attributs basées sur la classe System.Attribute. Les classes d'attributs, quant à elles, utilisent un attribut nommé AttributeUsageAttribute pour fournir des informations au sujet de la manière dont l'attribut peut être employé. Le fait de spécifier Inherited = True indique qu'un attribut peut se propager aux classes dérivées. Lorsque la propriété AllowMultiple a la valeur True, vous pouvez appliquer plusieurs instances de l'attribut à un élément de programme. Quant à l'énumération AttributeTargets, elle permet de définir les genres d'éléments de programme auxquels votre attribut peut s'appliquer.

Dans le code suivant, l'attribut AttributeUsageAttribute est un attribut qui peut être appliqué à n'importe quel type d'élément, qui peut être hérité, mais qui n'est applicable qu'une seule fois :

<AttributeUsage(AttributeTargets.All, Inherited:=True, AllowMultiple:=False)> _
Class TestAttribute1
    Inherits Attribute
End Class

Vous pouvez utiliser l'opérateur Or pour combiner plusieurs éléments de l'énumération AttributeTargets, comme l'illustre le code suivant :

<AttributeUsage(AttributeTargets.Class Or AttributeTargets.Method)> _
Class TestAttribute2
    Inherits Attribute
End Class

Dans cette section

• Comment : définir vos propres attributs
  Explique comment créer vos propres attributs à l'aide de classes d'attributs.

• Comment : récupérer les attributs Custom
  Explique comment récupérer des attributs personnalisés à l'aide de GetCustomAttribute ou de GetCustomAttributes.

• Exemples d'utilisation d'attributs personnalisés
  Fournit un exemple de code qui définit un attribut personnalisé pouvant être appliqué uniquement aux classes et montre comment utiliser ce nouvel attribut.

Rubriques connexes

• Visual Basic et le .NET Framework
  Décrit le rôle de Visual Basic dans le .NET Framework.

• Programmation orientée objet dans Visual Basic
  Fournit des informations au sujet de la programmation orientée objet et sur son utilisation.

• Métadonnées et composants autodescriptifs
  Fournit des informations détaillées sur les types de métadonnées utilisés dans Visual Studio, y compris sur les attributs.