Le langage de programmation informatique Microsoft Visual Basic est populaire dans les cercles de programmation depuis de nombreuses années. Les programmeurs l'utilisent pour toutes sortes de projets. Des variantes de ce langage de programmation sont utilisées pour les pages Web, et d'autres types de programmes Visual Basic sont utilisés pour de nombreuses applications Windows que nous utilisons quotidiennement. L'un des éléments essentiels de Visual Basic est la possibilité d'inclure des commentaires, qui sont des notes intégrées dans le code qui n'ont pas d'objectif de code fonctionnel. Visual Basic utilise un protocole spécifique pour les distinguer du code. L'ajout de commentaires est extrêmement important dans la plupart des projets pour aider les utilisateurs de code humain à lire correctement les modules de code. Si vous devez ajouter des commentaires à Visual Basic, voici quelques-unes des étapes fondamentales pour vous assurer que vous le faites correctement.
Pas
Étape 1. Déterminez le type de commentaire que vous souhaitez ajouter
Les programmeurs ont plusieurs objectifs principaux différents pour les commentaires qui déterminent le format et le style exacts de ce qui sera inclus dans le commentaire.
- Tenez compte des commentaires du module de code. Les commentaires de module sont des commentaires de niveau supérieur qui décrivent généralement les objectifs généraux du module de code, ainsi que d'autres informations telles que le droit d'auteur, la paternité, etc.
- Évaluer la nécessité de commentaires sur la procédure. Diverses procédures du code fonctionnel doivent également être commentées. Les commentaires de procédure se rapportent aux fonctions spécifiques du code, et ils aident à alerter les autres programmeurs sur les résultats exacts d'une procédure selon la façon dont elle est écrite.
Étape 2. Choisissez des catégories d'utilisation détaillées pour vos commentaires de code
Certains types de commentaires, comme les commentaires de procédure, se présentent également sous différentes formes. Comprenez ces différentes utilisations afin d'ajouter les bons types de commentaires à votre programme.
- Évaluer l'utilisation des commentaires d'objectif pour les procédures. Ceux-ci décrivent ce que fait la procédure.
- Envisagez l'utilisation de commentaires de valeur de retour de fonction. Ceux-ci aideront les autres à comprendre quelles valeurs sont renvoyées par la procédure.
- Inclure des commentaires conditionnels. Les commentaires conditionnels peuvent décrire les conditions d'erreur possibles et la gestion des erreurs, ainsi que les conditions qui doivent être remplies pour que le code fonctionne correctement.
Étape 3. Choisissez un format pour les commentaires
Il y a aussi la question de savoir comment vous allez ajouter des commentaires à des lignes de code spécifiques.
- Utilisez les commentaires pour gauchers. Ces commentaires commencent à gauche de l'écran et continuent tout le long d'une ligne. Généralement, le codeur doit terminer arbitrairement le commentaire près du côté droit de l'écran, descendre à une nouvelle ligne et continuer le commentaire.
- Utilisez des commentaires en ligne. Les commentaires en ligne ont une apostrophe directement après un morceau de code et sont placés sur la même ligne.
Étape 4. Utilisez une apostrophe pour marquer le début de vos commentaires
C'est l'étape clé pour réellement écrire des commentaires dans le code. L'apostrophe est le protocole de texte spécifique que le compilateur Visual Basic reconnaît pour les commentaires. Sans cela, l'ordinateur essaiera de lire les commentaires sous forme de code.
