Comment : utiliser XML des extraits de codeHow to: Use XML snippets

Vous pouvez invoquer des extraits XML en utilisant les deux commandes suivantes du menu contextuel de l'éditeur XML.You can invoke XML snippets by using the following two commands on the XML Editor shortcut menu. Le insérer un extrait commande insère l’extrait XML à la position du curseur.The Insert Snippet command inserts the XML snippet at the cursor position. Le entourer commande encapsule l’extrait XML autour du texte sélectionné.The Surround With command wraps the XML snippet around the selected text. Chaque extrait XML possède des types d'extrait désignés.Each XML snippet has designated snippet types. Le type d’extrait détermine si l’extrait de code est disponible avec le insérer un extrait commande, le entourer commande, ou les deux.The snippet types determine whether the snippet is available with the Insert Snippet command, the Surround With command, or both.

Une fois l'extrait XML ajouté à l'éditeur, tous ses champs modifiables sont surlignés en jaune et le curseur est placé dans le premier d'entre eux.After the XML snippet has been added to the editor, any editable fields in the snippet are highlighted in yellow, and the cursor is positioned on the first editable field.

Insérer l’extrait de codeInsert snippet

Les procédures suivantes décrivent comment accéder à la insérer un extrait commande.The following procedures describe how to access the Insert Snippet command.

Note

Le insérer un extrait commande est également disponible via un raccourci clavier (Ctrl+K, puis Ctrl + X).The Insert Snippet command is also available through the keyboard shortcut (Ctrl+K, then Ctrl+X).

Pour insérer des extraits à partir du menu contextuelTo insert snippets from the shortcut menu

  1. Placez le curseur à l'endroit où vous souhaitez insérer l'extrait XML.Position the cursor where you want to insert the XML snippet.

  2. Avec le bouton droit et sélectionnez insérer un extrait.Right-click and select Insert Snippet.

    Une liste des extraits XML disponibles s'affiche.A list of available XML snippets is displayed.

  3. Sélectionnez un extrait de code dans la liste à l’aide de la souris, ou en tapant le nom de l’extrait de code et en appuyant sur onglet ou entrée.Select a snippet from the list using the mouse, or by typing the name of the snippet and pressing Tab or Enter.

Pour insérer des extraits à l'aide du menu IntelliSenseTo insert snippets using the IntelliSense menu

  1. Placez le curseur à l'endroit où vous souhaitez insérer l'extrait XML.Position the cursor where you want to insert the XML snippet.

  2. À partir de la modifier menu, pointez sur IntelliSense, puis sélectionnez insérer un extrait.From the Edit menu, point to IntelliSense, and then select Insert Snippet.

    Une liste des extraits XML disponibles s'affiche.A list of available XML snippets is displayed.

  3. Sélectionnez un extrait de code dans la liste à l’aide de la souris ou en tapant le nom de l’extrait de code et en appuyant sur onglet ou entrée.Select a snippet from the list using the mouse or by typing the name of the snippet and pressing Tab or Enter.

Pour insérer des extraits via la liste de remplissage IntelliSenseTo insert snippets through the IntelliSense Complete Word list

  1. Placez le curseur à l'endroit où vous souhaitez insérer l'extrait XML.Position the cursor where you want to insert the XML snippet.

  2. Commencez à entrer l'extrait XML à ajouter à votre fichier.Begin typing the XML snippet that you want to add to your file. Si le remplissage automatique est activé, la liste de remplissage IntelliSense s'affiche.If automatic completion is turned on, the IntelliSense complete word list is displayed. Si elle n’apparaît pas, appuyez sur Ctrl+espace pour l’activer.If it does not appear, press Ctrl+Space to activate it.

  3. Sélectionnez l'extrait XML dans la liste de remplissage.Select the XML snippet from the complete word list.

  4. Appuyez sur onglet, onglet pour invoquer l’extrait XML.Press Tab, Tab to invoke the XML snippet.

Note

Parfois, l'extrait XML n'est pas invoqué.There may be cases when the XML snippet does not get invoked. Par exemple, si vous tentez d'insérer un élément xs:complexType dans un nœud xs:element, l'éditeur ne génère aucun extrait XML.For example, if you try to insert an xs:complexType element inside an xs:element node, the editor does not generate an XML snippet. En effet, lorsqu'un élément xs:complexType est utilisé à l'intérieur d'un nœud xs:element, aucun attribut ni sous-élément n'est requis, de sorte que l'éditeur n'a aucune donnée à insérer.When an xs:complexType element is used inside an xs:element node, there are no required attributes or subelements, so the editor does not have any data to insert.

Pour insérer des extraits à l'aide du nom raccourciTo insert snippets using the shortcut name

  1. Placez le curseur à l'endroit où vous souhaitez insérer l'extrait XML.Position the cursor where you want to insert the XML snippet.

  2. Entrez < dans le volet de l'éditeur.Type < in the editor pane.

  3. Appuyez sur ÉCHAP pour fermer la liste de remplissage IntelliSense.Press Esc to close the IntelliSense complete word list.

  4. Tapez le nom du raccourci de l’extrait de code, appuyez sur onglet pour invoquer l’extrait XML.Type the shortcut name of the snippet, and press Tab to invoke the XML snippet.

Entourer deSurround With

Les procédures suivantes décrivent comment accéder à la entourer commande.The following procedures describe how to access the Surround With command.

Note

Le entourer commande est également disponible via un raccourci clavier (Ctrl+K, puis Ctrl + S).The Surround With command is also available through the keyboard shortcut (Ctrl+K, then Ctrl+S).

Pour utiliser la commande Entourer de du menu contextuelTo use surround with from the context menu

  1. Sélectionnez le texte à entourer dans l'éditeur XML.Select the text to surround in the XML Editor.

  2. Avec le bouton droit et sélectionnez entourer.Right-click and select Surround With.

    Une liste des encadrements d'extraits XML disponibles s'affiche.A list of available surrounds with XML snippets is displayed.

  3. Sélectionnez un extrait de code dans la liste à l’aide de la souris, ou en tapant le nom de l’extrait de code et en appuyant sur onglet ou entrée.Select a snippet from the list using the mouse, or by typing the name of the snippet and pressing Tab or Enter.

Pour utiliser un encadrement à partir du menu IntelliSenseTo use surround with from the IntelliSense menu

  1. Sélectionnez le texte à entourer dans l'éditeur XML.Select the text to surround in the XML Editor.

  2. À partir de la modifier menu, pointez sur IntelliSense, puis sélectionnez entourer.From the Edit menu, point to IntelliSense, and then select Surround With.

    Une liste des encadrements d'extraits XML disponibles s'affiche.A list of available surrounds with XML snippets is displayed.

  3. Sélectionnez un extrait de code dans la liste à l’aide de la souris, ou en tapant le nom de l’extrait de code et en appuyant sur onglet ou entrée.Select a snippet from the list using the mouse, or by typing the name of the snippet and pressing Tab or Enter.

Utilisation d’extraits XMLUsing XML snippets

Une fois que vous avez choisi un extrait XML, le texte de cet extrait de code est automatiquement inséré à l'emplacement du curseur.Once you choose an XML snippet, the text of the code snippet is inserted automatically at the cursor position. Tous les champs modifiables contenus dans l'extrait sont surlignés et le premier de ces champs est automatiquement sélectionné.Any editable fields in the snippet are highlighted, and the first editable field is selected automatically. Le champ actuellement sélectionné est encadré.The currently selected field is boxed.

Après avoir sélectionné un champ, vous pouvez y entrer une nouvelle valeur.When a field is selected, you can type a new value for the field. En appuyant sur onglet parcourt les champs modifiables de l’extrait de code ; en appuyant sur MAJ+onglet parcourt dans l’ordre inverse.Pressing Tab cycles through the editable fields of the snippet; pressing Shift+Tab cycles through them in reverse order. Cliquer dans un champ place le curseur dans ce champ ; double-cliquer sur un champ permet de le sélectionner.Clicking a field places the cursor in the field, and double-clicking a field selects it. Lorsqu'un champ est en évidence, une info-bulle peut s'afficher pour le décrire.When a field is highlighted, a ToolTip might be displayed, offering a description of the field.

Seule la première instance d'un champ donné est modifiable.Only the first instance of a given field is editable. Lorsque ce champ est surligné, les autres instances du même champ sont mises en évidence.When that field is highlighted, the other instances of that field are outlined. Lorsque vous modifiez la valeur d'un champ modifiable, ce champ change partout où il est utilisé dans l'extrait.When you change the value of an editable field, that field is changed everywhere it is used in the snippet.

En appuyant sur entrée ou ÉCHAP annule la modification du champ et retourne l’éditeur à la normale.Pressing Enter or Esc cancels field editing and returns the editor to normal.

Les couleurs par défaut pour les champs d’extrait de code modifiable peuvent être modifiées en modifiant le paramètre du champ extrait de Code dans le polices et couleurs volet de la Options boîte de dialogue.The default colors for editable code snippet fields can be changed by modifying the Code Snippet Field setting in the Fonts and Colors pane of the Options dialog box. Pour plus d’informations, consultez Comment : modifier les polices et couleurs dans l’éditeur.For more information, see How to: Change Fonts and Colors in the Editor.

Voir aussiSee also