Liste d'attributs (Visual Basic)

Article
06/01/2023

Spécifie les attributs à appliquer à un élément de programmation déclaré. Les attributs multiples sont séparés par des virgules. Voici la syntaxe d’un attribut.

Syntaxe

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Éléments

Élément	Description
`attributemodifier`	Obligatoire pour les attributs appliqués au début d’un fichier source. Il peut s’agir d’un Assembly ou d’un Module.
`attributename`	Obligatoire. Nom de l'attribut.
`attributearguments`	Optionnel. Liste des arguments positionnels pour cet attribut. Les arguments sont séparés par des virgules.
`attributeinitializer`	Optionnel. Liste des initialiseurs de variable ou de propriété pour cet attribut. Plusieurs initialiseurs sont séparés par des virgules.

Notes

Vous pouvez appliquer un ou plusieurs attributs à presque n’importe quel élément de programmation (types, procédures, propriétés, etc.). Les attributs apparaissent dans les métadonnées de votre assembly et peuvent vous aider à annoter votre code ou à spécifier comment utiliser un élément de programmation particulier. Vous pouvez appliquer des attributs définis par Visual Basic et .NET Framework, et vous pouvez définir vos propres attributs.

Pour plus d’informations sur l’utilisation des attributs, consultez Vue d’ensemble des attributs. Pour plus d’informations sur les noms d’attributs, consultez Noms d’éléments déclarés.

Règles

Placement. Vous pouvez appliquer des attributs à la plupart des éléments de programmation déclarés. Pour appliquer un ou plusieurs attributs, vous placez un bloc d’attribut au début de la déclaration d’élément. Chaque entrée de la liste d’attributs spécifie un attribut que vous souhaitez appliquer, ainsi que le modificateur et les arguments que vous utilisez pour cet appel de l’attribut.
Crochets obliques. Si vous fournissez une liste d’attributs, vous devez la placer entre crochets (« < » et « > »).
Partie de la déclaration. L’attribut doit faire partie de la déclaration d’élément, et non d’une instruction distincte. Vous pouvez utiliser la séquence de continuation de ligne (« _ ») pour étendre l’instruction de déclaration sur plusieurs lignes de code source.
Modificateurs. Un modificateur d’attribut (Assembly ou Module) est requis sur chaque attribut appliqué à un élément de programmation au début d’un fichier source. Les modificateurs d’attribut ne sont pas autorisés sur les attributs appliqués aux éléments qui ne se trouvent pas au début d’un fichier source.
Arguments. Tous les arguments positionnels d’un attribut doivent précéder les initialiseurs de variable ou de propriété.

Exemple

L’exemple suivant applique l’attribut DllImportAttribute à une définition de squelette d’une procédure Function.

<DllImportAttribute("kernel32.dll", EntryPoint:="MoveFileW",
    SetLastError:=True, CharSet:=CharSet.Unicode,
    ExactSpelling:=True,
    CallingConvention:=CallingConvention.StdCall)>
Public Shared Function MoveFile(ByVal src As String,
  ByVal dst As String) As Boolean
    ' This function copies a file from the path src to the path dst.
    ' Leave this function empty. The DLLImport attribute forces calls
    ' to MoveFile to be forwarded to MoveFileW in KERNEL32.DLL.
End Function

DllImportAttribute indique que la procédure attribuée représente un point d’entrée dans une bibliothèque de liens dynamiques (DLL) non managée. L’attribut fournit le nom de la DLL en tant qu’argument positionnel et les autres informations en tant qu’initialiseurs de variables.

Partager via