Partager via

Créer des extraits XML

Vous pouvez utiliser l’éditeur XML pour créer des extraits XML. Cet éditeur comporte un extrait XML appelé « Snippet », qui est souvent utilisé pour la création de nouveaux extraits XML.

Pour créer un nouvel extrait XML

Pour créer un extrait de code XML, créez un fichier XML et utilisez la fonctionnalité Insérer un extrait.

  1. Dans le menu Fichier, cliquez sur Nouveau, puis sur Fichier.

  2. Cliquez sur Fichier XML, puis sur Ouvrir.

  3. Cliquez avec le bouton droit dans le volet de l’éditeur et sélectionnez Insérer un extrait.

  4. Sélectionnez Extrait de code dans la liste et appuyez sur Entrée.

  5. Apportez les modifications voulues au nouvel extrait.

  6. Dans le menu Fichier, sélectionnez Enregistrer XMLFile.xml.

    La boîte de dialogue Enregistrer le fichier sous s’affiche.

  7. Entrez le nom du nouvel extrait et sélectionnez Fichiers d’extraits dans la liste déroulante Type de fichier.

  8. Utilisez la liste déroulante Enregistrer dans pour remplacer l’emplacement du fichier par My Documents\Visual Studio 2005\Code Snippets\XML\My XML Snippets, puis cliquez sur Enregistrer.

Description des extraits de code

Cette section décrit certains éléments clés de l'extrait souvent utilisé. Pour plus d’informations sur les éléments de schéma utilisés par les extraits XML, consultez Référence de schéma des extraits de code.

SnippetType, élément

L'éditeur prend en charge deux types d'extraits :

<SnippetTypes>
  <SnippetType>SurroundsWith</SnippetType>
  <SnippetType>Expansion</SnippetType>
</SnippetTypes>

Le type Expansion détermine si l’extrait apparaît quand vous appelez la commande Insérer un extrait. Le type SurroundsWith détermine si l’extrait apparaît quand vous appelez la commande Entourer de.

Élément de code

L'élément Code définit le texte XML qui sera inséré lorsque l'extrait sera appelé.

Notes

Le texte de l'extrait XML doit être placé dans une section <![CDATA[...]]>.

L'élément Code suivant est créé par l'extrait souvent utilisé.

<Code Language="XML">
  <![CDATA[<test>
  <name>$name$</name>
  $selected$ $end$</test>]]>
</Code>

L'élément Code inclut trois variables.

  • $name$ est une variable définie par l'utilisateur. Elle crée un élément name dont la valeur par défaut modifiable est « name ». Les variables définies par l'utilisateur se définissent à l'aide de l'élément Literal.

  • $selected$ est une variable prédéfinie. Elle représente le texte sélectionné dans l’éditeur XML avant que vous appeliez l’extrait. La position de cette variable détermine l'emplacement du texte sélectionné dans l'extrait de code qui entoure cette sélection.

  • $end$ est une variable prédéfinie. Quand l’utilisateur appuie sur Entrée pour terminer l’édition des champs de l’extrait de code, cette variable détermine la position du point d’insertion (^).

    L'élément Code ci-dessus insère le texte XML suivant :

<test>
  <name>name</name>
</test>

La valeur de l'élément name est marquée comme une zone modifiable.

Literal, élément

L'élément Literal permet d'identifier le texte de remplacement qui peut être personnalisé après son insertion dans le fichier. Par exemple, des chaînes littérales, des valeurs numériques et certains noms de variables peuvent être déclarés comme littéraux. Vous pouvez définir un nombre quelconque de littéraux dans votre extrait XML et y faire référence plusieurs fois dans l'extrait. L'exemple d'élément Literal suivant définit une variable $name$ dont la valeur par défaut est « name ».

<Literal>
  <ID>name</ID>
  <Default>name</Default>
</Literal

Les littéraux peuvent également faire référence à des fonctions. L’éditeur XML comprend une fonction nommée LookupPrefix. La fonction LookupPrefix recherche l’URI d’espace de noms donné depuis l’emplacement du document XML où cet extrait est appelé et retourne le préfixe éventuel qui est défini pour cet espace de noms, notamment le signe deux-points (:) contenu dans ce nom. Voici un exemple d’élément Literal qui utilise la fonction LookupPrefix.

<Literal Editable="false">
   <ID>prefix</ID>
   <Function>LookupPrefix("namespaceURI")</Function>
</Literal>

La variable $prefix$ _peut alors être utilisée ailleurs dans votre extrait XML.

Contenu connexe