Partager via

Conventions d'affectation de noms Visual Basic

  • Article

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 aux composants CLS ( Language Independence and Language-Independent Components).

Les suggestions suivantes s’appliquent au nommage.

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

  • Commencez les noms des fonctions et des méthodes avec un verbe, comme dans InitNameArray ou CloseDialog.

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

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

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

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

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

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

  • Évitez d’utiliser des noms dans une portée interne qui sont identiques aux noms d’une portée externe. Des 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édant 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