Liste d’attributs (Visual Basic)

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

Syntaxe

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]  

Pièces

Remarques

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 d’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

• Positionnement. 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’attributs 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 les modificateurs et arguments que vous utilisez pour cet appel de l’attribut.

• Équerres. Si vous fournissez une liste d’attributs, vous devez l’inclure 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’attributs ne sont pas autorisés sur les 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 toutes les variables ou initialiseurs de propriété.

Exemple :

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

<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 non managées (DLL). L’attribut fournit le nom de la DLL en tant qu’argument positionnel et les autres informations sous forme d’initialiseurs de variables.

Voir aussi

• Assemblée
• Mot clé du module <>
• Vue d’ensemble des attributs
• Guide pratique pour interrompre et combiner des instructions dans le code