<?xml version="1.0" encoding="utf-8"?>
<CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
<CodeSnippet Format="1.0.0">
<Header>
<Title>Ce qui apparait dans l'intelisence</Title>
<Shortcut>
</Shortcut>
<Description>Décrit ce que le snippet créé.</Description>
<Author>auteur</Author>
</Header>
<Snippet>
<Declarations>
Ici on declare les variables
L’élément Declarations (optionnel) contient les paramètres du code. Il en existe deux types :
L’élément Literal (optionnel) est un paramètre textuel du Snippet, c’est-à-dire un texte simple comme un identifiant (nom de variable, classe), une chaîne, un nombre qui est inclus entièrement dans le Snippet
Elément ID (obligatoire) : id du paramètre pour substitution dans le code du Snippet. Dans le code, l’id du paramètre doit se trouver entre « $ » et peut se trouver plusieurs fois. Cet ID ne peut pas être selected ou end qui sont des mots réservés
Elément Function (optionnel) : supporté uniquement pour C# et J#, fonction à exécuter lors du passage de la sélection dans le paramètre. Par exemple, la génération d’un switch « GenerateSwitchCases ». Voir Code Snippet Functions
Elément ToolTip (optionnel) : définit le tooltip qui s’affiche lors du survol du paramètre
Elément Default (obligatoire) : définit la valeur par défaut du paramètre tel qu’il apparaîtra dans le Snippet inséré
Attribut Editable (optionnel) : indique si le paramètre est éditable. Cela peut servir par exemple pour un paramètre qui est le résultat d’une fonction Function (par exemple, simplification d’un type) et qui ne doit pas être changé
L’élément Object (optionnel) est un paramètre textuel du Snippet externe au Snippet, c’est-à-dire en général un objet référencé en dehors du Snippet comme un nom de contrôle ou une variable d’une classe :
Elément ID (obligatoire) : id du paramètre pour substitution dans le code du Snippet. Dans le code, l’id du paramètre doit se trouver entre « $ » et peut se trouver plusieurs fois. Cet ID ne peut pas être selected ou end qui sont des mots réservés
Elément ToolTip (optionnel) : définit le tooltip qui s’affiche lors du survol du paramètre
Elément Default (obligatoire) : définit la valeur par défaut du paramètre tel qu’il apparaîtra dans le Snippet inséré
Elément Function (optionnel) : supporté uniquement pour C# et J#, fonction à exécuter lors du passage de la sélection dans le paramètre. Par exemple, la génération d’un switch « GenerateSwitchCases ». Voir Code Snippet Functions
Elément Type (obligatoire) : définit le nom complet du type du paramètre. Cela permet à Intellisense de savoir l’autocompletion à réaliser pour le paramètre.
</Declarations>
<Code Language="csharp">
<![CDATA[
Ici le code du snippet
Les paramètres définis comme Literal se substituent dans le code par leur ID entouré de « $ »
Il existe deux types de Snippets : Expansion et SurroundsWith
Les paramètres s’insèrent à l’endroit voulu dans le code du Snippet et correspondent aux ID (entourés de « $ ») des éléments Literal et Object
Il existe deux types de paramètres :
Paramètre externe : élément Object, définit un paramètre qui référence une instance d’objet qui se trouve en dehors du Snippet comme un contrôle Winform, un nom
Paramètre interne : élément Literal, définit un paramètre référençant un littéral (nombre ou chaîne) ou un identifiant de variable qui se trouve à l’intérieur du Snippet
Il y a deux paramètres spéciaux :
$selected$ : substitué par le texte sélectionné lors de l’utilisation du Snippet
$end$ : indique où sera placé le curseur après l’édition des paramètres du Snippet. Ce mot clé n’est pas géré en Visual Basic
Le code doit se trouver dans un <![CDATA[ … ]]> afin de ne pas perturber le XML englobant.
]]></Code>
</Snippet>
</CodeSnippet>
</CodeSnippets>
