Noms d'éléments déclarés

Article
09/12/2008

Mise à jour : novembre 2007

Chaque élément déclaré a un nom, également appelé identificateur, utilisé par le code pour faire référence à l'élément déclaré.

Règles

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

commencer par un caractère alphabétique ou un trait de soulignement (_) ;
contenir uniquement des caractères alphabétiques, des chiffres décimaux et des traits de soulignement ;
comprendre au moins un caractère alphabétique ou un chiffre décimal s'il commence par un trait de soulignement ;
être inférieur ou égal à 1 023 caractères.

La longueur maximale de 1 023 caractères s'applique également à un nom qualifié complet, tel que : outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement.

Vous trouverez ci-dessous des exemples de noms d'éléments valides.

aB123__45

_567

Vous trouverez ci-dessous des exemples de noms d'éléments non valides. Le premier contient uniquement un trait de soulignement, le second 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ément commençant par un trait de soulignement (_) ne font pas partie de la spécification CLS (Spécification CLS (Common Language Specification)) ; par conséquent, le code conforme CLS ne peut pas utiliser de composant qui définit ce type de noms. Toutefois, un trait de soulignement inséré à toute autre position dans un nom d'élément est conforme à la spécification CLS.

Indications sur la longueur du nom

D'un point de vue pratique, votre nom doit être aussi court que possible tout en identifiant clairement la nature de l'élément. La lisibilité de votre code s'en trouve améliorée, et la justification et la taille de fichier source réduites.

En revanche, votre nom ne doit pas être court au point de ne pas décrire suffisamment ce que l'élément représente et comment votre code l'utilise. Cette considération est importante pour la lisibilité de votre code. Si une autre personne essaie de le comprendre ou si vous l'examinez longtemps après l'avoir écrit, des noms d'éléments appropriés peuvent vous faire gagner un temps précieux.

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, tels 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 puisque la présence des crochets lève toute ambiguïté. Vous pouvez également utiliser les crochets lorsque vous faites référence au nom ultérieurement dans votre code.

En général, vous devez utiliser des noms échappés uniquement dans les cas suivants :

Votre code a effectué une migration d'une version antérieure de Visual Basic qui n'a pas réservé le mot clé utilisé comme un nom ; ou
vous utilisez du code écrit dans un autre langage dans lequel 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 d'effectuer cette opération. Pour plus d'informations, consultez Comment : renommer un identificateur.

Respect de la casse dans les noms

Les noms d'éléments dans Visual Basic ne respectent pas la casse. En d'autres termes, lorsque le compilateur compare deux noms qui ne se distinguent que par la casse, il les interprète comme un seul et même nom. Il considère, par exemple, que ABC et abc font référence au même élément déclaré.

Néanmoins, le Common Language Runtime (CLR) utilise des liaisons qui respectent la casse. En conséquence, lorsque vous générez un assembly ou une DLL et que vous les mettez à la disposition d'autres assemblys, vos noms respectent alors la casse. Par exemple, si vous définissez une classe avec un élément appelé ABC et que d'autres assemblys utilisent votre classe via le Common Language Runtime, ils doivent faire référence à l'élément sous la forme ABC. Si, par la suite, vous recompilez votre classe et que vous changez le nom de l'élément en abc, les autres assemblys qui utilisent votre classe ne peuvent plus accéder à cet élément. Dès lors, lorsque vous libérez une version mise à jour d'un assembly, évitez de modifier la casse des éléments publics.

Noms et paramètres régionaux

La comparaison de noms est indépendante des paramètres régionaux. Si deux noms correspondent dans des paramètres régionaux spécifiques, ils correspondent dans tous.