Partager via


Comment : créer un extrait de code simple

Les extraits de code IntelliSense sont des fichiers XML dotés d'une extension de nom de fichier .snippet qui sont conformes au schéma XML des extraits de code IntelliSense. Dans cette rubrique, vous allez créer un extrait de code de base qui affiche un message. Pour plus d'informations sur le schéma XML des extraits de code, consultez Référence de schéma des extraits de code.

Création d'un fichier d'extrait

Pour créer un fichier d'extrait, vous devez créer un fichier XML, puis entrer le code XML qui compose votre extrait de code. Pour plus d'informations sur chacun des éléments XML utilisés dans les exemples suivants, consultez Référence de schéma des extraits de code.

Pour créer un fichier d'extrait

  1. Créez un fichier XML, puis ouvrez-le dans l'éditeur.

  2. Sous la ligne de code XML générée automatiquement, ajoutez un élément CodeSnippets avec la valeur d'attribut xmlns appropriée, et un élément CodeSnippet pour créer un extrait de code individuel. Par exemple :

    <CodeSnippets xmlns="https://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
        <CodeSnippet Format="1.0.0">
    
  3. Ajoutez une section d'en-tête à l'extrait de code. Par exemple :

    <Header>
        <Title>
            My Snippet
        </Title>
    </Header>
    
  4. Ajoutez les éléments qui définissent l'extrait de code lui-même. Dans l'exemple suivant, le langage de l'extrait de code est Visual Basic.

    <Snippet>
        <Code Language="VB">
    
        </Code>
    </Snippet>
    

    Notes

    L'attribut Language accepte également les valeurs CSharp, VJSharp et XML. Pour plus d'informations, consultez Code, élément (extraits de code IntelliSense).

  5. À l'intérieur de l'élément Code, ajoutez le code Visual Basic pour l'extrait de code. Tout extrait de code doit être placé entre crochets <![CDATA[ et ]]>. Dans l'exemple suivant, le code qui sera inséré est MessageBox.Show("Hello World").

    <Code Language="VB">
        <![CDATA[MessageBox.Show("Hello World")]]>
    </Code>
    
  6. À l'intérieur de l'élément Snippet, ajoutez l'élément References et tous les éléments enfants requis qui ajoutent une référence au projet lorsque l'extrait de code est inséré. Dans cet exemple, l'extrait de code ajoute une référence à System.Windows.Forms.dll lorsque l'extrait de code est inséré.

    Notes

    Seuls les extraits de code Visual Basic prennent en charge la section References. Les extraits de code d'autres langages nécessitent que les références correctes soient ajoutées manuellement.

    <Snippet>
        <References>
            <Reference>
                <Assembly>System.Windows.Forms.dll</Assembly>
            </Reference>
        </References>
        <Code Language="VB">
            <![CDATA[MessageBox.Show("Hello World")]]>
        </Code>
    </Snippet>
    
  7. Dans le menu Fichier, cliquez sur Enregistrer <NomFichier> sous..., puis enregistrez le fichier au format .snippet.

Vous pouvez utiliser cet extrait de code IntelliSense dans Visual Studio en suivant les procédures dans Comment : gérer des extraits de code et Comment : insérer des extraits de code IntelliSense.

Exemple

Cet exemple contient l'extrait de code IntelliSense entier créé au cours des étapes précédentes.

<CodeSnippets
    xmlns="https://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
        <Header>
            <Title>
                My Snippet
            </Title>
        </Header>
        <Snippet>
            <References>
                <Reference>
                    <Assembly>System.Windows.Forms.dll</Assembly>
                </Reference>
            </References>
            <Code Language="VB">
                <![CDATA[MessageBox.Show("Hello World")]]>
            </Code>
        </Snippet>
    </CodeSnippet>
</CodeSnippets>

Cet exemple contient une version Visual C# de l'extrait de code IntelliSense créé dans les étapes précédentes. Étant donné que les extraits de code Visual C# ne pas prennent pas en charge la section References, une référence à System.Windows.Forms.dll doit être ajoutée manuellement au projet.

<CodeSnippets
    xmlns="https://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
        <Header>
            <Title>
                My Snippet
            </Title>
        </Header>
        <Snippet>
            <Code Language="CSharp">
                <![CDATA[MessageBox.Show("Hello World");]]>
            </Code>
        </Snippet>
    </CodeSnippet>
</CodeSnippets>

Voir aussi

Référence

Création d'extraits de code

Création et utilisation d'extraits de code IntelliSense

Concepts

Référence de schéma des extraits de code