Partager via

Conventions d’affectation de noms Visual Basic

Lorsque vous nommez un élément dans votre application Visual Basic, le premier caractère de ce nom doit être un caractère alphabétique ou un trait de soulignement. Notez toutefois que les noms commençant par un trait de soulignement ne sont pas conformes à l’indépendance du langage et aux composants Language-Independent (CLS).

Les suggestions suivantes s’appliquent à l’affectation de noms.

  • Commencez chaque mot distinct dans un nom avec une lettre majuscule, comme dans FindLastRecord et RedrawMyForm.

  • Commencer des noms de fonction et de méthode avec un verbe, comme dans InitNameArray ou CloseDialog.

  • Commencez la classe, la structure, le module et les noms de propriétés avec un nom, comme dans EmployeeName ou CarAccessory.

  • Commencez les noms d’interface avec le préfixe « I », suivi d’un nom ou d’une expression de nom, comme IComponent, ou avec un adjectif décrivant le comportement de l’interface, comme IPersistable. N’utilisez pas le trait de soulignement et utilisez des abréviations avec modération, car les abréviations peuvent entraîner une confusion.

  • Commencez les noms des gestionnaires d’événements avec un nom décrivant le type d’événement suivi du suffixe «EventHandler », comme dans «MouseEventHandler ».

  • Dans les noms des classes d’argument d’événement, incluez le suffixe «EventArgs ».

  • Si un événement a un concept de « avant » ou « après », utilisez un suffixe dans les temps présents ou passés, comme dans «ControlAdd » ou «ControlAdded ».

  • Pour des termes longs ou fréquemment utilisés, utilisez des abréviations pour conserver les longueurs de nom raisonnables, par exemple « HTML », au lieu de « Langage de balisage hypertexte ». En général, les noms de variables supérieurs à 32 caractères sont difficiles à lire sur un moniteur défini sur une résolution faible. Vérifiez également que vos abréviations sont cohérentes dans l’ensemble de l’application. Le basculement aléatoire dans un projet entre « HTML » et « Hypertext Markup Language » peut entraîner une confusion.

  • Évitez d'utiliser des noms dans une étendue interne qui sont identiques aux noms d'une étendue externe. Les erreurs peuvent se produire si la variable incorrecte est accessible. Si un conflit se produit entre une variable et le mot clé du même nom, vous devez identifier le mot clé en le précédent avec la bibliothèque de types appropriée. Par exemple, si vous avez une variable appelée Date, vous pouvez utiliser la fonction intrinsèque Date uniquement en appelant DateTime.Date.

Voir aussi