Extraits de codeCode snippets

Les extraits de code sont de petits blocs de code réutilisables que vous pouvez insérer dans un fichier de code à l'aide d'une commande de menu contextuel ou une combinaison de touches d'accès rapide.Code snippets are small blocks of reusable code that can be inserted in a code file using a context menu command or a combination of hotkeys. Ils contiennent généralement des blocs de code fréquemment utilisés, tels que les blocs try-finally ou if-else, mais ils permettent d’insérer des classes ou des méthodes entières.They typically contain commonly-used code blocks such as try-finally or if-else blocks, but they can be used to insert entire classes or methods.

Les extraits de code sont disponibles dans de nombreux langages : C#, C++, Visual Basic, XML, T-SQL, etc.Code snippets are available for a multitude of languages, including C#, C++, Visual Basic, XML, and T-SQL, to name a few. Pour afficher tous les extraits installés disponibles pour un langage, ouvrez le Gestionnaire des extraits de code à partir du menu Outils dans Visual Studio, puis choisissez le langage dans le menu déroulant situé dans la partie supérieure.To view all the available installed snippets for a language, open the Code Snippets Manager from the Tools menu in Visual Studio, and choose the language from the drop-down menu at the top.

Boîte de dialogue Gestionnaire des extraits de code

Pour accéder aux extraits de code, plusieurs méthodes générales s’offrent à vous :Code snippets can be accessed in the following general ways:

  • Dans la barre de menus, choisissez Edition > IntelliSense > Insérer un extrait...On the menu bar, choose Edit > IntelliSense > Insert Snippet...

  • Dans le menu contextuel (clic droit) de l’éditeur de code, choisissez Extrait > Insérer un extrait...From the right-click or context menu in the code editor, choose Snippet > Insert Snippet...

  • Si vous préférez utiliser le clavier, appuyez sur Ctrl+K+X.From the keyboard, press Ctrl+K+X

Extraits d’expansion et extraits Entourer deExpansion snippets and surround-with snippets

Dans Visual Studio, il existe deux types d'extrait de code : les extraits d'extension, qui sont ajoutés à un point d'insertion spécifié et qui peuvent remplacer un raccourci d'extrait de code, et les extraits de code d'encerclement (C# et C++ uniquement), qui sont ajoutés autour d'un bloc de code sélectionné.In Visual Studio there are two kinds of code snippet: expansion snippets, which are added at a specified insertion point and may replace a snippet shortcut, and surround-with snippets (C# and C++ only), which are added around a selected block of code.

Exemple d'extrait de code d'extension : en C#, le raccourci tryf est utilisé pour insérer un bloc try-finally :An example of an expansion snippet: in C# the shortcut tryf is used to insert a try-finally block:

try
{

}
finally
{

}

Pour insérer cet extrait, cliquez sur Insérer un extrait dans le menu contextuel de la fenêtre de code, cliquez sur Visual C#, tapez tryf, puis appuyez sur Tab. Vous pouvez aussi taper tryf et appuyer deux fois sur Tab.You can insert this snippet by clicking Insert Snippet in the context menu of the code window, then Visual C#, then type tryf, and then press Tab. Or, you can type tryf and press Tab twice.

Exemple d'extrait de code d'encerclement : en C++, le raccourci if peut être utilisé comme un extrait d'insertion ou comme un extrait de code d'encerclement.An example of a surround-with snippet: in C++ the shortcut if can be used either as an insertion snippet or as a surround-with snippet. Si vous sélectionnez une ligne de code (par exemple, return FALSE;), et que vous choisissez ensuite Entourer de > if, l’extrait est développé autour de la ligne :If you select a line of code (for example return FALSE;), and then choose Surround With > if, the snippet is expanded around the line:

if (true)
{
    return FALSE;
}

Paramètres de remplacement d’extrait de codeSnippet replacement parameters

Les extraits de code peuvent contenir des paramètres de remplacement, qui sont des espaces réservés que vous devez remplacer en fonction du code précis que vous écrivez.Snippets can contain replacement parameters, which are placeholders that you must replace to fit the precise code you are writing. Dans l'exemple précédent, true est un paramètre de remplacement, que vous pouvez remplacer par la condition appropriée.In the previous example true is a replacement parameter, which you would replace with the appropriate condition. Cette condition que vous apportez est répétée pour chaque instance du même paramètre de remplacement dans l'extrait de code.The replacement you make is repeated for every instance of the same replacement parameter in the snippet.

Par exemple, en Visual Basic, un extrait de code insère une propriété.For example, in Visual Basic there is a code snippet that inserts a property. Pour insérer l’extrait de code, choisissez Extrait de code... > Insérer un extrait à partir du menu contextuel (clic droit) d’un fichier de code Visual Basic.To insert the snippet, choose Snippet... > Insert Snippet from the right-click or context menu in a Visual Basic code file. Ensuite, choisissez Modèles de code > Propriétés, procédures, événements > Définir une propriété.Then, choose Code Patterns > Properties, Procedures, Events > Define a Property.

Menu Extrait de code pour Définir une propriété

Le code suivant est inséré :The following code is inserted:

Private newPropertyValue As String
Public Property NewProperty() As String
    Get
        Return newPropertyValue
    End Get
    Set(ByVal value As String)
        newPropertyValue = value
    End Set
End Property

Si vous remplacez newPropertyValue par m_property, chaque instance de newPropertyValue est modifiée.If you change newPropertyValue to m_property, then every instance of newPropertyValue is changed. Si vous remplacez String par Int dans la déclaration de propriété, la valeur de la méthode set est également remplacée par Int.If you change String to Int in the property declaration, then the value in the set method is also changed to Int.

Voir aussiSee also