Découvrir comment utiliser l’éditeur de code avec Visual Basic

Dans cette présentation de 10 minutes de l’éditeur de code de Visual Studio, vous allez ajouter du code dans un fichier pour découvrir comment Visual Studio facilite l’écriture, la navigation et la compréhension du code Visual Basic.

Conseil

Si vous n’avez pas encore installé Visual Studio, accédez à la page Téléchargements Visual Studio pour l’installer gratuitement.

Cet article part du principe que vous connaissez déjà Visual Basic. Si ce n’est pas le cas, nous vous suggérons de commencer par consulter un tutoriel comme Créer une application console Visual Basic (VB) simple.

Conseil

Pour suivre cet article, vérifiez que vous avez sélectionné les paramètres Visual Basic pour Visual Studio. Pour plus d’informations sur la sélection des paramètres pour l’environnement de développement intégré (IDE), consultez Sélectionner les paramètres d’environnement.

Créer un fichier de code

Vous allez commencer par créer un fichier et y ajouter du code.

  1. Ouvrez Visual Studio. Appuyez sur Échap ou cliquez sur Continuer sans code dans la fenêtre de démarrage pour ouvrir l’environnement de développement.

  2. Dans le menu Fichier de la barre de menus, choisissez Nouveau Fichier.

  3. Dans la boîte de dialogue Nouveau fichier, sous la catégorie Général, choisissez Classe Visual Basic, puis choisissez Ouvrir.

    Un nouveau fichier qui s’ouvre dans l’éditeur présente le squelette d’une classe Visual Basic. (Notez que vous n’êtes pas obligés de créer un projet Visual Studio complet pour bénéficier de certains avantages offerts par l’éditeur de code, comme la coloration syntaxique. Vous avez uniquement besoin d’un fichier de code)

    Screenshot showing a new Visual Basic class file in the Visual Studio code editor.

  1. Ouvrez Visual Studio. Appuyez sur Échap ou sélectionnez Continuer sans code dans la fenêtre de démarrage pour ouvrir l’environnement de développement.

  2. Dans le menu Fichier de la barre de menus, choisissez Nouveau>Fichier.

  3. Dans la boîte de dialogue Nouveau fichier, sous la catégorie Général, choisissez Classe Visual Basic, puis choisissez Ouvrir.

    Un nouveau fichier qui s’ouvre dans l’éditeur présente le squelette d’une classe Visual Basic. (Notez que vous n’êtes pas obligés de créer un projet Visual Studio complet pour bénéficier de certains avantages offerts par l’éditeur de code, comme la coloration syntaxique. Vous avez uniquement besoin d’un fichier de code)

    Screenshot showing a new Visual Basic class file in the Visual Studio code editor.

Utiliser des extraits de code

Visual Studio fournit des extraits de code qui vous aident à créer rapidement et facilement les blocs de code couramment utilisés. Ces extraits de code sont disponibles pour plusieurs langages de programmation, y compris Visual Basic, C# et C++. Ajoutons l’extrait de code Sub Visual Basic à notre fichier.

  1. Placez votre curseur au-dessus de la ligne indiquant End Class et le type sub.

    Une boîte de dialogue contextuelle affiche des informations sur le mot clé Sub et relatives à l’insertion de l’extrait de code Sub.

    Screenshot showing the IntelliSense for a 'Sub' code snippet in Visual Studio.

  2. Appuyez deux fois sur Tab pour insérer l’extrait de code.

    La présentation de la procédure Sub MySub() est ajoutée au fichier.

Les extraits de code disponibles diffèrent en fonction des langages de programmation. Vous pouvez examiner les extraits de code disponibles pour Visual Basic en choisissant Modifier>IntelliSense>Insérer un extrait de code (ou appuyez sur CTRL+K, Ctrl+X). Dans Visual Basic, les extraits de code sont disponibles pour les catégories suivantes :

Screenshot showing the Insert Snippet window with a list of category folders that contain Visual Basic code snippets.

Des extraits de code permettent de déterminer si un fichier existe sur l’ordinateur, d’écrire dans un fichier texte, de lire une valeur de Registre, d’exécuter une requête SQL ou créer une instruction For Each...Next, etc.

  1. Placez votre curseur au-dessus de la ligne indiquant End Class et le type sub.

    Une boîte de dialogue contextuelle affiche des informations sur le mot clé Sub et relatives à l’insertion de l’extrait de code Sub.

    Screenshot showing the IntelliSense for a 'Sub' code snippet in Visual Studio.

  2. Appuyez deux fois sur Tab pour insérer l’extrait de code.

    La présentation de la procédure Sub MySub() est ajoutée au fichier.

Les extraits de code disponibles diffèrent en fonction des langages de programmation. Vous pouvez examiner les extraits de code disponibles pour Visual Basic en ouvrant le menu contextuel (en cliquant avec le bouton droit) dans l’éditeur de code et en choisissant Extrait de code>Insérer un extrait (ou appuyez sur Ctrl+K, Ctrl+X). Dans Visual Basic, les extraits de code sont disponibles pour les catégories suivantes :

Screenshot showing the Insert Snippet window with a list of category folders that contain Visual Basic code snippets.

Commenter du code

La barre d’outils, qui est la ligne de boutons sous la barre de menus dans Visual Studio, peut aider à augmenter votre productivité quand vous codez. Par exemple, vous pouvez activer ou désactiver le mode de saisie semi-automatique IntelliSense, augmenter ou réduire un retrait d’une ligne, ou commenter du code que vous ne voulez pas compiler. (IntelliSense est une aide au codage qui affiche une liste de méthodes correspondantes, entre autres.) Dans cette section, nous allons commenter du code.

Screenshot showing the toolbar in Visual Studio which includes buttons for adding or removing code comments.

  1. Collez le code suivant dans le corps de la procédure MySub().

    ' _words is a string array that we'll sort alphabetically
    Dim _words = New String() {
    "the",
    "quick",
    "brown",
    "fox",
    "jumps"
    }
    
    Dim morewords = New String() {
    "over",
    "the",
    "lazy",
    "dog"
    }
    
    Dim query = From word In _words
                Order By word.Length
                Select word
    
  2. Nous n’utilisons pas le tableau morewords, mais nous n’allons pas le supprimer complètement car nous en aurons peut-être besoin plus tard. Au lieu de cela, nous allons commenter ces lignes. Sélectionnez toute la définition de morewords jusqu’à l’accolade de fin, puis choisissez le bouton Commenter les lignes sélectionnées dans la barre d’outils. Si vous préférez utiliser le clavier, appuyez sur Ctrl+K, Ctrl+C.

    Screenshot showing the toolbar with the button for commenting out code highlighted in red.

    Le caractère de commentaire Visual Basic ' est ajouté au début de chaque ligne sélectionnée pour commenter le code.

Screenshot showing the toolbar in Visual Studio which includes buttons for adding or removing code comments.

  1. Collez le code suivant dans le corps de la procédure MySub().

    ' _words is a string array that we'll sort alphabetically
    Dim _words = New String() {
    "the",
    "quick",
    "brown",
    "fox",
    "jumps"
    }
    
    Dim morewords = New String() {
    "over",
    "the",
    "lazy",
    "dog"
    }
    
    Dim query = From word In _words
                Order By word.Length
                Select word
    
  2. Nous n’utilisons pas le tableau morewords, mais nous n’allons pas le supprimer complètement car nous en aurons peut-être besoin plus tard. Au lieu de cela, nous allons commenter ces lignes. Sélectionnez toute la définition de morewords jusqu’à l’accolade de fin, puis choisissez le bouton Commenter les lignes sélectionnées dans la barre d’outils. Si vous préférez utiliser le clavier, appuyez sur Ctrl+K, Ctrl+C.

    Screenshot showing the toolbar with the button for commenting out code highlighted in red.

    Le caractère de commentaire Visual Basic ' est ajouté au début de chaque ligne sélectionnée pour commenter le code.

Réduire les blocs de code

Vous pouvez réduire des sections de code pour vous concentrer uniquement sur les parties qui vous intéressent. Pour nous entraîner, nous allons réduire le tableau _words à une seule ligne de code. Choisissez la petite case grise avec le signe moins qui se trouve dans la marge de la ligne indiquant Dim _words = New String() {. Si vous préférez utiliser le clavier, placez le curseur n’importe où dans la définition du tableau et appuyez sur Ctrl+M, Ctrl+M.

Screenshot showing the Visual Studio Code editor, with the control for collapsing the outline of a section of code highlighted in red.

Le bloc de code est réduit de façon à afficher uniquement la première ligne, suivie de points de suspension (...). Pour redévelopper le bloc de code, cliquez sur la même case grise, qui affiche maintenant un signe plus, ou appuyez sur Ctrl+M, Ctrl+M à nouveau. Cette fonctionnalité, appelée Mode Plan, est très utile pour réduire des méthodes longues ou des classes entières.

Vous pouvez réduire des sections de code pour vous concentrer uniquement sur les parties qui vous intéressent. Pour nous entraîner, nous allons réduire le tableau _words à une seule ligne de code. Choisissez la petite case grise avec le signe moins qui se trouve dans la marge de la ligne indiquant Dim _words = New String() {. Si vous préférez utiliser le clavier, placez le curseur n’importe où dans la définition du tableau et appuyez sur Ctrl+M, Ctrl+M.

Screenshot showing the Visual Studio Code editor, with the control for collapsing the outline of a section of code highlighted in red.

Le bloc de code est réduit de façon à afficher uniquement la première ligne, suivie de points de suspension (...). Pour redévelopper le bloc de code, choisissez la même case grise, qui affiche désormais un signe plus, ou appuyez sur Ctrl+M, Ctrl+M à nouveau. Cette fonctionnalité, appelée Mode Plan, est très utile pour réduire des méthodes longues ou des classes entières.

Afficher les définitions de symbole

L’éditeur Visual Studio facilite l’inspection de la définition d’un type, d’une méthode, etc. L’une des méthodes consiste à accéder au fichier qui contient la définition, par exemple en choisissant Accéder à la définition partout où le symbole est référencé. Une autre façon encore plus rapide, sans avoir à déplacer le focus en dehors du fichier dans lequel vous travaillez, consiste à utiliser la fonctionnalité Aperçu de la définition. Vous allez afficher un aperçu de la définition du type String.

  1. Cliquez avec le bouton droit sur le mot String, puis choisissez Aperçu de la définition dans le menu de contenu. Ou bien, appuyez sur Alt+F12.

    Une fenêtre indépendante s’affiche, avec la définition de la classe String. Vous pouvez faire défiler le contenu de la fenêtre indépendante, ou même afficher un aperçu de la définition d’un autre type à partir du code en aperçu.

    Screenshot showing a Peek Definition pop-up window containing the definition of the 'String' class.

  2. Fermez la fenêtre Aperçu de la définition en choisissant la petite case avec un « x » dans le coin supérieur droit de la fenêtre indépendante.

L’éditeur Visual Studio facilite l’inspection de la définition d’un type ou membre de classe. Une façon de faire est d’accéder au fichier qui contient la définition, par exemple en choisissant Atteindre la définition à partir de n’importe quel endroit où le symbole est référencé. Une autre façon encore plus rapide, sans avoir à déplacer le focus en dehors du fichier dans lequel vous travaillez, consiste à utiliser la fonctionnalité Aperçu de la définition. Vous allez afficher un aperçu de la définition du type String.

  1. Cliquez avec le bouton droit sur le mot String, puis choisissez Aperçu de la définition dans le menu de contenu. Ou bien, appuyez sur Alt+F12.

    Une fenêtre indépendante s’affiche, avec la définition de la classe String. Vous pouvez faire défiler le contenu de la fenêtre indépendante, ou même afficher un aperçu de la définition d’un autre type à partir du code en aperçu.

    Screenshot showing a Peek Definition pop-up window containing the definition of the 'String' class.

  2. Fermez la fenêtre Faire un Peek de la Définition en choisissant la petite case « x » en haut à droite de la fenêtre contextuelle.

Utiliser IntelliSense pour compléter des mots

IntelliSense est une aide précieuse quand vous écrivez du code. Cette fonctionnalité peut afficher des informations sur les membres d’un type disponibles, ou les détails des paramètres des différentes surcharges d’une méthode. Vous pouvez également utiliser IntelliSense pour compléter un mot automatiquement quand vous avez tapé suffisamment de caractères pour lever toute ambiguïté sur le mot. Nous allons ajouter une ligne de code pour imprimer les chaînes ordonnées dans la fenêtre de console, qui est l’emplacement standard pour la sortie du programme.

  1. Sous la variable query, commencez à taper le code suivant :

    For Each str In qu
    

    IntelliSense affiche une Info express relative au symbole query.

    Screenshot showing the IntelliSense word completion window for the word 'query' in the Visual Studio code editor.

  2. Pour insérer le reste du mot query à l’aide la fonctionnalité de complétion de mot d’IntelliSense, appuyez sur Tab.

  3. Terminez le bloc de code pour obtenir le code suivant.

    For Each str In query
        Console.WriteLine(str)
    Next
    

IntelliSense est une aide précieuse quand vous écrivez du code. Cette fonctionnalité peut afficher des informations sur les membres d’un type disponibles, ou les détails des paramètres des différentes surcharges d’une méthode. Vous pouvez également utiliser IntelliSense pour compléter un mot automatiquement quand vous avez tapé suffisamment de caractères pour lever toute ambiguïté sur le mot. Nous allons ajouter une ligne de code pour imprimer les chaînes ordonnées dans la fenêtre de console, qui est l’emplacement standard pour la sortie du programme.

  1. Sous la variable query, commencez à taper le code suivant :

    For Each str In qu
    

    IntelliSense affiche une Info express relative au symbole query.

    Screenshot showing the IntelliSense word completion window for the word 'query' in the Visual Studio code editor.

  2. Pour insérer le reste du mot query à l’aide la fonctionnalité de complétion de mot d’IntelliSense, appuyez sur Tab.

  3. Terminez le bloc de code pour obtenir le code suivant.

    For Each str In query
        Console.WriteLine(str)
    Next
    

Refactoriser un nom

Aucun développeur ne réussit à créer un code parfait dès le départ. L’une de vos premières modifications sera probablement de changer le nom d’une variable ou d’une méthode. Nous allons donc essayer la fonctionnalité Refactoriser de Visual Studio pour renommer la variable _words en words.

  1. Placez votre curseur sur la définition de la variable _words, puis choisissez Renommer dans le menu contextuel (clic droit).

    Une boîte de dialogue contextuelle Renommer s’affiche en haut à droite de l’éditeur.

  2. Avec la variable _words toujours sélectionnée, tapez le nom de votre choix pour mots. Notez que la référence à words dans la requête est également renommée automatiquement. Avant d’appuyer sur Entrée ou de cliquer sur Appliquer, cochez la case Inclure les commentaires dans la boîte de dialogue contextuelle Renommer.

    Screenshot showing the Rename dialog box for the variable '_words', with the option for 'Include comments' checked.

  3. Appuyez sur Entrée ou cliquez sur Appliquer.

    Les deux occurrences de words sont renommées, tout comme la référence à words dans le commentaire de code.

Aucun développeur ne réussit à créer un code parfait dès le départ. L’une de vos premières modifications sera probablement de changer le nom d’une variable ou d’une méthode. Nous allons donc essayer la fonctionnalité Refactoriser de Visual Studio pour renommer la variable _words en words.

  1. Placez votre curseur sur la définition de la variable _words, puis choisissez Renommer dans le menu contextuel (clic droit).

    Une boîte de dialogue contextuelle Renommer s’affiche en haut à droite de l’éditeur.

  2. Avec la variable _words toujours sélectionnée, tapez le nom de votre choix pour mots. Notez que la référence à words dans la requête est également renommée automatiquement. Avant d’appuyer sur Entrée ou Appliquer, cochez la case Inclure les commentaires dans la boîte de dialogue contextuelle Renommer.

    Screenshot showing the Rename dialog box for the variable '_words', with the option for 'Include comments' checked.

  3. Appuyez sur Entrée ou choisissez Appliquer.

    Les deux occurrences de words sont renommées, tout comme la référence à words dans le commentaire de code.

Étapes suivantes

Voir aussi