Partager via

Noms d’éléments déclarés (Visual Basic)

Chaque élément déclaré a un nom, également appelé identificateur, qui est ce que le code utilise pour y faire référence.

Règles

Un nom d’élément dans Visual Basic doit respecter les règles suivantes :

  • Il doit commencer par un caractère alphabétique ou un trait de soulignement (_).

  • Il ne doit contenir que des caractères alphabétiques, des chiffres décimaux et des traits de soulignement.

  • Il doit contenir au moins un caractère alphabétique ou un chiffre décimal s’il commence par un trait de soulignement.

  • Il ne doit pas contenir plus de 1023 caractères.

La limite de longueur de 1023 caractères s’applique également à la chaîne entière d’un nom complet, par outerNamespace.middleNamespace.innerNamespace.thisClass.thisElementexemple .

L’exemple suivant montre des noms d’éléments valides.

aB123__45

_567

L’exemple suivant montre des noms d’éléments non valides. Le premier contient uniquement un trait de soulignement, le deuxième commence par un chiffre décimal et le troisième contient un caractère non valide ($).

' Three INVALID element names

_

12ABC

xyz$wv

Avertissement

Les noms d’éléments commençant par un trait de soulignement (_) ne font pas partie de l’indépendance du langage et des composants Language-Independent (CLS), de sorte que le code conforme CLS ne peut pas utiliser un composant qui définit ces noms. Toutefois, un trait de soulignement dans une autre position dans un nom d’élément est conforme CLS.

Instructions relatives à la longueur du nom

En pratique, votre nom doit être aussi court que possible tout en identifiant clairement la nature de l’élément. Cela améliore la lisibilité de votre code et réduit la longueur de ligne et la taille du fichier source.

En revanche, votre nom ne doit pas être si court qu’il ne décrit pas correctement ce que l’élément représente et comment votre code l’utilise. Cela est important pour la lisibilité de votre code. Si quelqu’un d’autre essaie de le comprendre, ou si vous le regardez longtemps après l’avoir écrit, les noms d’éléments appropriés peuvent économiser beaucoup de temps.

Noms échappés

En règle générale, un nom d’élément ne doit correspondre à aucun des mots clés réservés par Visual Basic, tel que Case ou Friend. Toutefois, vous pouvez définir un nom d’échappement, placé entre crochets ([ ]). Un nom d’échappement peut correspondre à n’importe quel mot clé Visual Basic, car les crochets suppriment toute ambiguïté. Vous utilisez également les crochets lorsque vous faites référence au nom plus loin dans votre code.

En général, vous devez utiliser des noms échappés uniquement lorsque :

  • Votre code a migré à partir d’une version précédente de Visual Basic qui n’a pas réservé le mot clé utilisé comme nom ; ou

  • Vous utilisez du code écrit dans une autre langue dans laquelle le mot clé donné n’est pas réservé.

Sinon, vous devez envisager de renommer l’élément si son nom est en conflit avec un mot clé. L’environnement de développement intégré (IDE) offre un moyen simple de procéder. Pour plus d’informations, consultez Refactorisation.

Sensibilité de la casse dans les noms

Les noms d’éléments en Visual Basic ne respectent pas la casse. Cela signifie que lorsque le compilateur compare deux noms qui diffèrent en cas alphabétique uniquement, il les interprète comme le même nom. Par exemple, il considère ABC et abc fait référence au même élément déclaré.

Toutefois, le Common Language Runtime (CLR) utilise une liaison respectant la casse. Par conséquent, lorsque vous produisez un assembly ou une DLL et que vous le mettez à la disposition d’autres assemblys, vos noms ne respectent plus la casse. Par exemple, si vous définissez une classe avec un élément appelé ABC, et d’autres assemblys utilisent votre classe via le Common Language Runtime, ils doivent faire référence à l’élément comme ABC. Si vous recompilez par la suite votre classe et modifiez le nom abcde l’élément, les autres assemblys utilisant votre classe ne peuvent plus accéder à cet élément. Par conséquent, lorsque vous publiez une version mise à jour d’un assembly, vous ne devez pas modifier la casse alphabétique des éléments publics.

Noms et paramètres régionaux

La comparaison des noms est indépendante des paramètres régionaux. Si deux noms correspondent dans un seul paramètre régional, ils sont garantis de correspondre dans tous les paramètres régionaux.

Voir aussi