Apprendre à utiliser l’éditeur de code avec C#

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 de quelles façons Visual Studio facilite l’écriture, la navigation et la compréhension du code C#.

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

Cet article suppose de connaître C#. Si ce n’est pas votre cas, nous vous suggérons de commencer par un tutoriel comme Bien démarrer avec C# et ASP.NET Core dans Visual Studio.

Conseil

Pour suivre cet article, vérifiez que vous avez sélectionné les paramètres C# 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 ou appuyez sur Ctrl+N.

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

    Le nouveau fichier qui s’ouvre dans l’éditeur présente le squelette d’une classe C#. (Notez que nous ne sommes pas obligés de créer un projet Visual Studio complet pour bénéficier de certains des avantages offerts par l’éditeur de code. Tout ce dont nous avons besoin, c’est d’un fichier de code.)

    Screenshot of a C# code file in Visual Studio.

  1. Ouvrez Visual Studio. Appuyez sur Échap ou choisissez 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 ou appuyez sur Ctrl+N.

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

    Le nouveau fichier qui s’ouvre dans l’éditeur présente le squelette d’une classe C#. Vous n’êtes pas obligés de créer un projet Visual Studio complet pour bénéficier de certains des avantages offerts par l’éditeur de code. Tout ce dont vous avez besoin, c’est d’un fichier de code.

    Screenshot of a C# code file in Visual Studio 2022.

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 C#, Visual Basic et C++.

Vous allez maintenant ajouter l’extrait de code void Main C# dans votre fichier.

  1. Placez votre curseur juste au-dessus de l’accolade fermante finale } dans le fichier et tapez les caractères svm (ce qui signifie static void Main - ne vous inquiétez pas trop si vous ne savez pas ce que cela veut dire).

    Une boîte de dialogue contextuelle affiche des informations relatives à l’extrait de code svm.

    Screenshot of an IntelliSense pop-up for a code snippet in Visual Studio.

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

    La signature de la méthode static void Main() est ajoutée au fichier. La méthode Main() est le point d’entrée pour les applications C#.

Les extraits de code disponibles diffèrent en fonction des langages de programmation. Pour voir quels extraits de code sont disponibles pour votre langage, choisissez Modifier>IntelliSense>Insérer extrait ou appuyez sur Ctrl+K, Ctrl+X, puis choisissez le dossier de votre langage. Pour C#, la liste ressemble à ceci :

Screenshot of an IntelliSense pop-up for a C# code snippet list.

  1. Placez votre curseur juste au-dessus de l’accolade fermante finale } dans le fichier, puis tapez les caractères svm. svm signifie static void Main - ne vous inquiétez pas si vous ne savez pas encore ce que cela signifie.

    Une boîte de dialogue contextuelle affiche des informations relatives à l’extrait de code svm.

    Screenshot of an IntelliSense pop-up for a code snippet in Visual Studio 2022.

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

    Vous verrez la signature de la méthode static void Main() ajoutée au fichier. La méthode Main() est le point d’entrée pour les applications C#.

Les extraits de code disponibles diffèrent en fonction des langages de programmation. Vous pouvez consulter les extraits de code disponibles pour votre langage en choisissant Modifier>IntelliSense>Insérer un extrait de code ou en appuyant sur Ctrl+K et Ctrl+X, puis en choisissant le dossier de votre langage de programmation. Pour C#, la liste d’extraits de code ressemble à ceci :

Screenshot of an IntelliSense pop-up for a C# code snippet list.

La liste contient des extraits de code permettant de créer une classe, un constructeur, une boucle for, une instruction if ou switch, et bien d’autres éléments.

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 basculer le mode de complétion IntelliSense (IntelliSense est une aide au codage qui affiche entre autres une liste de méthodes correspondantes), augmenter ou réduire un retrait de ligne, ou commenter du code que vous ne souhaitez pas compiler. Dans cette section, nous allons commenter du code.

Screenshot of the Editor toolbar in Visual Studio.

  1. Collez le code suivant dans le corps de la méthode Main().

    // _words is a string array that we'll sort alphabetically
    string[] _words = {
        "the",
        "quick",
        "brown",
        "fox",
        "jumps"
    };
    
    string[] morewords = {
        "over",
        "the",
        "lazy",
        "dog"
    };
    
    IEnumerable<string> query = from word in _words
                                orderby word.Length
                                select word;
    
  2. Nous n’avons pas besoin de la variable morewords ici, mais nous n’allons pas la 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’au point-virgule 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 of the Comment out button in the Editor toolbar in Visual Studio.

    Les caractères de commentaire C# // sont ajoutés au début de chaque ligne sélectionnée pour commenter le code.

La barre d’outils, qui est la ligne de boutons sous la barre de menus dans Visual Studio, permet d’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.

Screenshot of the Text Editor toolbar in Visual Studio 2022.

Nous allons commenter du code.

  1. Collez le code suivant dans le corps de la méthode Main().

    // someWords is a string array.
    string[] someWords = {
        "the",
        "quick",
        "brown",
        "fox",
        "jumps"
    };
    
    string[] moreWords = {
        "over",
        "the",
        "lazy",
        "dog"
    };
    
    // Alphabetically sort the words.
    IEnumerable<string> query = from word in someWords
                                orderby word
                                select word;
    
  2. Nous n’avons pas besoin de la variable moreWords ici, mais nous la conservons pour un usage ultérieur. Au lieu de cela, nous allons commenter ces lignes. Sélectionnez toute la définition de moreWords jusqu’au point-virgule 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+E, Ctrl+C.

    Screenshot of the Comment out button in the Text Editor toolbar in Visual Studio 2022.

    Les caractères de commentaire C# // sont ajoutés au début de chaque ligne sélectionnée pour commenter le code.

Réduire les blocs de code

Nous n’avons pas besoin de voir le constructeur vide de Class1 qui a été généré. Pour plus de lisibilité, nous allons donc réduire ce bloc de code. Choisissez la petite case grise avec le signe moins qui se trouve dans la marge de la première ligne du constructeur. Si vous préférez utiliser le clavier, placez le curseur n’importe où dans le code du constructeur et appuyez sur Ctrl+M, Ctrl+M.

Screenshot of the Outlining collapse button in the Text Editor toolbar in Visual Studio.

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.

Screenshot of the Outlining collapse button in the Text Editor toolbar in Visual Studio 2022.

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, sélectionnez 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.

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 ou en appuyant sur F12 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 une occurrence de 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 of a Peek definition window in Visual Studio.

  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 de Visual Studio facilite l’inspection de la définition d’un type, d’une méthode ou d’une variable. L’une des façons consiste à accéder à la définition, quel que soit le fichier, en choisissant Accéder à la définition ou en appuyant sur F12 partout où un symbole est référencé. Une autre façon encore plus rapide, sans avoir à déplacer le focus en dehors du code 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 une occurrence de 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 of the Peek definition window in Visual Studio 2022.

  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 :

    foreach (string str in qu
    

    IntelliSense affiche une Info express relative au symbole query.

    Screenshot of an IntelliSense word completion pop-up in Visual Studio.

  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. Si vous voulez vous exercer un peu plus avec des extraits de code, entrez cw et appuyez deux fois sur Tab pour générer le code Console.WriteLine.

    foreach (string str in query)
    {
       Console.WriteLine(str);
    }
    

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 :

    foreach (string str in qu
    

    Une fenêtre contextuelle IntelliSense s’affiche avec des informations sur le symbole query.

    Screenshot of an IntelliSense word completion pop-up in Visual Studio 2022.

  2. Pour insérer le reste du mot query à l’aide de la saisie semi-automatique IntelliSense, appuyez sur Tab.

  3. Terminez le bloc de code pour obtenir le code suivant. Vous pouvez continuer à utiliser des extraits de code en entrant cw, puis en appuyant sur Tab deux fois pour générer l’instruction Console.WriteLine.

    foreach (string str in query)
    {
       Console.WriteLine(str);
    }
    

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), ou appuyez sur Ctrl+R, Ctrl+R.

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

  2. Entrez le nom souhaité, words. Notez que la référence à words dans la requête est également renommée automatiquement. Avant d’appuyer sur Entrée, cochez la case Inclure les commentaires dans la boîte de dialogue contextuelle Renommer.

    Screenshot of a Rename dialog box in Visual Studio.

  3. Appuyez sur Entrée.

    Les deux occurrences de words ont été 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 someWords en unsortedWords.

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

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

    Screenshot of the Rename pop-up box within the editor of Visual Studio 2022.

  2. Entrez le nom souhaité, unsortedWords. Vous verrez que la référence à unsortedWords dans l’instruction d'assignation query est également renommée automatiquement. Avant d’appuyer sur Entrée, cochez la case Inclure les commentaires dans la boîte de dialogue contextuelle Renommer.

    Screenshot of the Rename pop-up box in Visual Studio 2022.

  3. Appuyez sur Entrée ou choisissez Appliquer dans la boîte de dialogue Renommer.

    Les deux occurrences de someWords dans votre code ont été renommées, tout comme le texte someWords dans le commentaire de votre code.

Étapes suivantes

Voir aussi