Cómo: usar XML fragmentos de códigoHow to: Use XML snippets

Puede invocar fragmentos XML mediante los dos siguientes comandos del menú contextual del Editor XML.You can invoke XML snippets by using the following two commands on the XML Editor shortcut menu. El Insertar fragmento de código comando inserta el fragmento XML en la posición del cursor.The Insert Snippet command inserts the XML snippet at the cursor position. El rodear con comando ajusta el fragmento XML alrededor del texto seleccionado.The Surround With command wraps the XML snippet around the selected text. Cada fragmento XML tiene designados tipos de fragmentos.Each XML snippet has designated snippet types. Los tipos de fragmentos determinan si el fragmento está disponible con la Insertar fragmento de código comando, el rodear con , o ambos.The snippet types determine whether the snippet is available with the Insert Snippet command, the Surround With command, or both.

Una vez que el fragmento XML se ha agregado al editor, todos los campos editables del fragmento se resaltan en amarillo y el cursor se coloca en el primer campo editable.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.

Insertar fragmento de códigoInsert snippet

Los procedimientos siguientes describen cómo tener acceso a la Insertar fragmento de código comando.The following procedures describe how to access the Insert Snippet command.

Nota

El Insertar fragmento de código comando también está disponible mediante el método abreviado de teclado (Ctrl+K, a continuación, Ctrl + X).The Insert Snippet command is also available through the keyboard shortcut (Ctrl+K, then Ctrl+X).

Para insertar fragmentos desde el menú contextualTo insert snippets from the shortcut menu

  1. Coloque el cursor en el lugar en el que desea insertar el fragmento XML.Position the cursor where you want to insert the XML snippet.

  2. Haga clic en y seleccione Insertar fragmento de código.Right-click and select Insert Snippet.

    Se muestra una lista de fragmentos XML disponibles.A list of available XML snippets is displayed.

  3. Seleccione un fragmento de la lista con el mouse o escribiendo el nombre del fragmento y presione ficha o ENTRAR.Select a snippet from the list using the mouse, or by typing the name of the snippet and pressing Tab or Enter.

Para insertar fragmentos con el menú IntelliSenseTo insert snippets using the IntelliSense menu

  1. Coloque el cursor en el lugar en el que desea insertar el fragmento XML.Position the cursor where you want to insert the XML snippet.

  2. Desde el editar menú, elija IntelliSensey, a continuación, seleccione Insertar fragmento de código.From the Edit menu, point to IntelliSense, and then select Insert Snippet.

    Se muestra una lista de fragmentos XML disponibles.A list of available XML snippets is displayed.

  3. Seleccione un fragmento de la lista con el mouse o escribiendo el nombre del fragmento y presione ficha o ENTRAR.Select a snippet from the list using the mouse or by typing the name of the snippet and pressing Tab or Enter.

Para insertar fragmentos mediante la lista de palabras completas de IntelliSenseTo insert snippets through the IntelliSense Complete Word list

  1. Coloque el cursor en el lugar en el que desea insertar el fragmento XML.Position the cursor where you want to insert the XML snippet.

  2. Comience a escribir el fragmento XML que desea agregar al archivo.Begin typing the XML snippet that you want to add to your file. Si la finalización automática está activada, se muestra la lista de palabras completas de IntelliSense.If automatic completion is turned on, the IntelliSense complete word list is displayed. Si no aparece, presione Ctrl+espacio para activarla.If it does not appear, press Ctrl+Space to activate it.

  3. Seleccione el fragmento XML de la lista de palabras completas.Select the XML snippet from the complete word list.

  4. Presione ficha, ficha para invocar el fragmento XML.Press Tab, Tab to invoke the XML snippet.

Nota

Puede haber casos en los que el fragmento XML no se llegue a invocar.There may be cases when the XML snippet does not get invoked. Por ejemplo, si intenta insertar un elemento xs:complexType dentro de un nodo xs:element, el editor no genera un fragmento 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. Cuando un elemento xs:complexType se utiliza dentro de un nodo xs:element, no están los atributos o subelementos necesarios, así que el editor no tiene datos que insertar.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.

Para insertar fragmentos con el nombre de acceso directoTo insert snippets using the shortcut name

  1. Coloque el cursor en el lugar en el que desea insertar el fragmento XML.Position the cursor where you want to insert the XML snippet.

  2. Escriba < en el panel del editor.Type < in the editor pane.

  3. Presione Esc para cerrar la lista de palabras completas de IntelliSense.Press Esc to close the IntelliSense complete word list.

  4. Escriba el nombre de método abreviado del fragmento y presione ficha para invocar el fragmento XML.Type the shortcut name of the snippet, and press Tab to invoke the XML snippet.

Delimitar conSurround With

Los procedimientos siguientes describen cómo tener acceso a la rodear con comando.The following procedures describe how to access the Surround With command.

Nota

El rodear con comando también está disponible mediante el método abreviado de teclado (Ctrl+K, a continuación, Ctrl + S).The Surround With command is also available through the keyboard shortcut (Ctrl+K, then Ctrl+S).

Para utilizar este comando desde el menú de acceso directoTo use surround with from the context menu

  1. Seleccione el texto que se va a rodear en el Editor XML.Select the text to surround in the XML Editor.

  2. Haga clic en y seleccione rodear con.Right-click and select Surround With.

    Se muestra una lista de bordes disponibles con fragmentos XML.A list of available surrounds with XML snippets is displayed.

  3. Seleccione un fragmento de la lista con el mouse o escribiendo el nombre del fragmento y presione ficha o ENTRAR.Select a snippet from the list using the mouse, or by typing the name of the snippet and pressing Tab or Enter.

Para utilizar este comando en el menú de IntelliSenseTo use surround with from the IntelliSense menu

  1. Seleccione el texto que se va a rodear en el Editor XML.Select the text to surround in the XML Editor.

  2. Desde el editar menú, elija IntelliSensey, a continuación, seleccione rodear con.From the Edit menu, point to IntelliSense, and then select Surround With.

    Se muestra una lista de bordes disponibles con fragmentos XML.A list of available surrounds with XML snippets is displayed.

  3. Seleccione un fragmento de la lista con el mouse o escribiendo el nombre del fragmento y presione ficha o ENTRAR.Select a snippet from the list using the mouse, or by typing the name of the snippet and pressing Tab or Enter.

Uso de fragmentos XMLUsing XML snippets

Una vez elegido un fragmento XML, el texto del fragmento de código se inserta automáticamente en la posición del cursor.Once you choose an XML snippet, the text of the code snippet is inserted automatically at the cursor position. Todos los campos editables del fragmento se resaltan y el primero de estos campos se selecciona automáticamente.Any editable fields in the snippet are highlighted, and the first editable field is selected automatically. Al campo actualmente seleccionado se le aplica la conversión boxing.The currently selected field is boxed.

Cuando se selecciona un campo, puede escribir un nuevo valor para el mismo.When a field is selected, you can type a new value for the field. Al presionar ficha se desplaza por los campos editables del fragmento de código; si presiona MAYÚS+ficha recorrerá en orden inverso.Pressing Tab cycles through the editable fields of the snippet; pressing Shift+Tab cycles through them in reverse order. Al hacer clic en un campo, el cursor se coloca en dicho campo, y al hacer doble clic en él se selecciona.Clicking a field places the cursor in the field, and double-clicking a field selects it. Cuando un campo está resaltado, podría mostrarse información sobre herramientas, que ofrece una descripción del campo.When a field is highlighted, a ToolTip might be displayed, offering a description of the field.

Solo es editable la primera ocurrencia de un campo dado.Only the first instance of a given field is editable. Cuando ese campo está resaltado, las demás ocurrencias de dicho campo se destacan.When that field is highlighted, the other instances of that field are outlined. Si cambia el valor de un campo editable, ese campo cambia en cualquier parte en la que se utilice en el fragmento.When you change the value of an editable field, that field is changed everywhere it is used in the snippet.

Al presionar ENTRAR o Esc cancela la edición de los campos y el editor vuelve a su estado normal.Pressing Enter or Esc cancels field editing and returns the editor to normal.

Los colores predeterminados de los campos de fragmento de código modificable pueden cambiarse modificando la configuración de campo de fragmento de código en el fuentes y colores panel de la opciones cuadro de diálogo.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. Para obtener más información, consulte Cómo: cambiar fuentes y colores en el Editor de.For more information, see How to: Change Fonts and Colors in the Editor.

Vea tambiénSee also