Liste d'attributs (Visual Basic)

Article
08/10/2011

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

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Éléments

attributemodifier
Requis pour les attributs appliqués au début d'un fichier source. Peut être Assembly (Visual Basic) ou Module.
attributename
Obligatoire. Nom de l'attribut.
attributearguments
Facultatif. Liste d'arguments de position pour cet attribut. Les arguments multiples sont séparés par des virgules.
attributeinitializer
Facultatif. Liste d'initialiseurs de variable ou de propriété pour cet attribut. Les initialiseurs multiples sont séparés par des virgules.

Notes

Vous pouvez appliquer un ou plusieurs attributs à quasiment 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 ; ils 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 le .NET Framework et vous pouvez définir vos propres attributs.

Pour plus d'informations sur le moment où des attributs doivent être utilisés, consultez Attributs (C# et Visual Basic) . Pour plus d'informations sur les noms d'attributs, consultez Noms d'éléments déclarés (Visual Basic).

Règles

Positionnement. Vous pouvez appliquer des attributs à la plupart des éléments de programmation déclarés. Pour appliquer un ou plusieurs attributs, placez un bloc d'attributs au début de la déclaration d'élément. Chaque entrée dans 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.
Signes "inférieur à" et "supérieur à". Si vous fournissez une liste d'attributs, vous devez la placer entre des signes "inférieur à" et "supérieur à" ("<" et ">").
Partie de la déclaration. L'attribut doit faire partie de la déclaration d'élément, et non d'une instruction séparée. 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 des attributs appliqués aux éléments qui ne sont pas au début d'un fichier source.
Arguments. Tous les arguments positionnels d'un attribut doivent précéder n'importe quel initialiseur de propriété ou de variable.

Exemple

L'exemple suivant applique l'attribut DllImportAttribute à une définition 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 DLL comme argument positionnel et l'autre information comme initialiseurs de variable.