Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

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

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é.

En Visual Basic, un nom d'élément doit respecter 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

Mise en garde Attention

Les noms d'élément commençant par un trait de soulignement (_) ne font pas partie de la spécification CLS (Indépendance du langage et composants indépendants du langage) ; 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.

81ed9a62.collapse_all(fr-fr,VS.120).gifIndications 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.

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 migré à partir d'une version antérieure de Visual Basic qui n'a pas réservé le mot clé utilisé comme 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 Refactorisation et boîte de dialogue Renommer (Visual Basic).

En Visual Basic, les noms d'éléments 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.

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.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2015 Microsoft