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

  • Article

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, tel que outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement.

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

Attention

Les noms d’éléments commençant par un trait de soulignement (_) ne font pas partie des composants Language Independence et Language-Independent Components (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 d'échappement

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, comme Case ou Friend. Toutefois, vous pouvez définir un nom d’échappement, qui est 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 d’échappement 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 dans Visual Basic ne respectent pas la casse. Cela signifie que lorsque le compilateur compare deux noms dont la casse diffère uniquement, il les interprète comme le même nom. Par exemple, il considère que ABC et abc font référence au même élément déclaré.

Toutefois, le Common Language Runtime (CLR) utilise la liaison qui respecte la casse. Ainsi, quand vous générez un assembly ou une DLL et que vous le mettez à disposition d’autres assemblys, la casse de vos noms est respectée. Par exemple, si vous définissez une classe avec un élément nommé ABCet que d’autres assemblys utilisent votre classe par le biais du Common Language Runtime, ils doivent faire référence à l’élément en tant que ABC. Si vous recompilez par la suite votre classe et modifiez le nom de l’élément en abc, les autres assemblies utilisant votre classe ne peuvent plus accéder à cet élément. Ainsi, quand vous publiez une version mise à jour d’un assembly, vous ne devez pas modifier la casse des éléments publics.

Noms et paramètres locaux

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

Voir aussi