Partage via


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

Dans cette introduction de 10 minutes à l’éditeur de code dans Visual Studio, nous allons ajouter du code à un fichier pour examiner certaines des façons dont 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 part du principe que vous connaissez déjà C#. Si ce n’est pas le cas, nous vous suggérons de consulter un didacticiel tel que Bien démarrer avec C# et ASP.NET Core dans Visual Studio d’abord.

Conseil

Pour suivre cet article, vérifiez que les paramètres C# sont sélectionnés 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

Commencez 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 dans 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.

    Un nouveau fichier s’ouvre dans l’éditeur avec le squelette d’une classe C#. (Notez que nous n’avons pas besoin de créer un projet Visual Studio complet pour obtenir certains des avantages offerts par l’éditeur de code ; tout ce dont vous avez besoin est un fichier de code !)

    Capture d’écran d’un fichier de code C# dans 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 dans 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.

    Un nouveau fichier s’ouvre dans l’éditeur avec le squelette d’une classe C#. Vous n’avez pas besoin 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 est un fichier de code.

    Capture d’écran d’un fichier de code C# dans Visual Studio 2022.

Utiliser des extraits de code

Visual Studio fournit des extraits de code utiles que vous pouvez utiliser pour générer rapidement et facilement des blocs de code couramment utilisés. extraits de code sont disponibles pour différents langages de programmation, notamment C#, Visual Basic et C++.

Ajoutons l’extrait de code C# void Main à notre fichier.

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

    Une boîte de dialogue contextuelle s’affiche avec des informations sur l’extrait de code svm.

    Capture d’écran d’une fenêtre contextuelle IntelliSense pour un extrait de code dans Visual Studio.

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

    Vous voyez la signature de 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 varient selon les différents langages de programmation. Vous pouvez examiner les extraits de code disponibles pour votre langue en choisissant Modifier>IntelliSense>Insérer un extrait de code ou en appuyant sur Ctrl+K, Ctrl+X, puis en choisissant le dossier de votre langue. Pour C#, la liste ressemble à ceci :

Capture d’écran d’une fenêtre contextuelle IntelliSense pour une liste d’extraits de code C#.

  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 s’affiche avec des informations sur l’extrait de code svm.

    Capture d’écran d’une fenêtre contextuelle IntelliSense pour un extrait de code dans Visual Studio 2022.

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

    Vous verrez que la signature de 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 varient selon les différents langages de programmation. Vous pouvez examiner les extraits de code disponibles pour votre langue en choisissant Modifier>IntelliSense>Insérer un extrait de code ou en appuyant sur Ctrl+K, Ctrl+X, puis en choisissant le dossier de votre langage de programmation. Pour C#, la liste d’extraits de code ressemble à ceci :

Capture d’écran d’une fenêtre contextuelle IntelliSense pour une liste d’extraits de code C#.

La liste inclut des extraits de code pour créer une classe , un constructeur , une boucle pour, une instruction si ou switch, etc.

Commenter du code

La barre d’outils, qui est la ligne de boutons sous la barre de menus de Visual Studio, peut vous aider à rendre votre code plus productif. Par exemple, vous pouvez activer le mode d’achèvement IntelliSense ( IntelliSense est une aide de codage qui affiche une liste de méthodes correspondantes, entre autres), augmenter ou diminuer un retrait de ligne ou commenter le code que vous ne souhaitez pas compiler. Dans cette section, nous allons commenter du code.

Capture d’écran de la barre d’outils Éditeur dans 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’utilisons pas la variable morewords, mais nous pouvons l’utiliser ultérieurement afin de ne pas vouloir la supprimer complètement. Au lieu de cela, nous allons commenter ces lignes. Sélectionnez l'intégralité de la définition de morewords jusqu'au point-virgule de clôture, 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.

    Capture d’écran du bouton Mettre en commentaire dans la barre d’outils de l’éditeur dans 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 de Visual Studio, vous permet de vous rendre plus productif lorsque 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.

Capture d’écran de la barre d’outils Éditeur de texte dans 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’utilisons pas la variable moreWords, mais nous pouvons l’utiliser ultérieurement afin de ne pas vouloir la supprimer. Au lieu de cela, nous allons commenter ces lignes. Sélectionnez la définition entière de moreWords jusqu’au point-virgule fermant, puis choisissez le bouton Commenter les lignes sélectionnées de la barre d’outils. Si vous préférez utiliser le clavier, appuyez sur Ctrl+E, Ctrl+C.

    Capture d’écran du bouton Commentaire dans la barre d’outils Éditeur de texte dans 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. Ou, 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.

Capture d’écran du bouton Réduire en plan dans la barre d’outils Éditeur de texte dans Visual Studio 2022.

Le bloc de code s’réduit à la première ligne, suivi d’un point de suspension (...). Pour développer à nouveau le bloc de code, cliquez sur la même zone grise qui a maintenant un signe plus, ou appuyez à nouveau sur Ctrl+M, Ctrl+M. Cette fonctionnalité, appelée Mode Plan, est très utile pour réduire des méthodes longues ou des classes entières.

Capture d’écran du bouton Réduire en plan dans la barre d’outils Éditeur de texte dans Visual Studio 2022.

Le bloc de code s’réduit à la première ligne, suivi d’un point de suspension (...). Pour développer à nouveau le bloc de code, sélectionnez la même zone grise qui comporte maintenant un signe plus, ou appuyez à nouveau sur Ctrl+M, Ctrl+M. 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 symboles

L’éditeur Visual Studio facilite l’inspection de la définition d’un type, d’une méthode, etc. L’une des façons consiste à accéder au fichier qui contient la définition, par exemple en choisissant Atteindre la définition ou en appuyant sur F12 n’importe 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. Examinons 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 appuyez sur Alt+F12.

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

    Capture d’écran d’une fenêtre de définition d’aperçu dans Visual Studio.

  2. Fermez la fenêtre de définition aperçue en choisissant la petite boîte avec un « x » en haut à droite de la fenêtre contextuelle.

L’éditeur 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, dans quel fichier qu’il contient, en choisissant Atteindre la définition ou en appuyant sur F12 n’importe 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.

Examinons 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 appuyez sur Alt+F12.

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

    Capture d’écran de la fenêtre de définition d’aperçu dans Visual Studio 2022.

  2. Fermez la fenêtre de définition d’aperçu en choisissant la petite zone avec un « x » en haut à droite de la fenêtre contextuelle.

Utiliser IntelliSense pour compléter les mots

IntelliSense est une ressource inestimable lorsque vous codez. Il peut vous afficher des informations sur les membres disponibles d’un type ou des détails de paramètre pour différentes surcharges d’une méthode. Vous pouvez également utiliser IntelliSense pour terminer un mot après avoir tapé suffisamment de caractères pour le lever d’ambiguïté. Ajoutons 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.

    Capture d’écran d’une fenêtre contextuelle de saisie semi-automatique IntelliSense dans Visual Studio 2022.

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

  3. Terminez le bloc de code pour ressembler au code suivant. Vous pouvez même utiliser à nouveau des extraits de code en entrant cw, puis en appuyant sur Tab deux fois pour générer le code Console.WriteLine.

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

IntelliSense est une ressource inestimable lorsque vous codez. Il peut vous afficher des informations sur les membres disponibles d’un type ou des détails de paramètre pour différentes surcharges d’une méthode. Vous pouvez également utiliser IntelliSense pour terminer un mot après avoir tapé suffisamment de caractères pour le lever d’ambiguïté.

Ajoutons 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.

    Capture d’écran d’une fenêtre contextuelle de saisie semi-automatique IntelliSense dans 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 ressembler au code suivant. Vous pouvez continuer avec les 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

Personne n’obtient le code la première fois, et l’une des choses que vous devrez peut-être modifier est le nom d’une variable ou d’une méthode. Essayons la fonctionnalité de refactorisation de Visual Studio pour renommer la variable _words à words.

  1. Placez votre curseur sur la définition de la variable _words, puis choisissez Renommer dans le menu contextuel ou cliquez avec le bouton 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.

    Capture d’écran d’une boîte de dialogue Renommer dans Visual Studio.

  3. Appuyez sur Entrée.

    Les deux occurrences de words ont été renommées, ainsi que la référence à words dans le commentaire de code.

Personne n’obtient le code la première fois, et l’une des choses que vous devrez peut-être modifier est le nom d’une variable ou d’une méthode. Essayons la fonctionnalité de refactorisation 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 ou cliquez avec le bouton droit, ou appuyez sur F2.

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

    Capture d’écran de la zone contextuelle Renommer dans l’éditeur de Visual Studio 2022.

  2. Entrez le nom souhaité, unsortedWords. Vous verrez que la référence à unsortedWords dans l’instruction d’affectation 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.

    Capture d’écran de la zone contextuelle Renommer dans 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, ainsi que le texte someWords dans votre commentaire de code.

Étapes suivantes

Voir aussi