Code (Elemento, fragmentos de código IntelliSense)

Artículo
08/10/2011

Proporciona un contenedor para los bloques de código cortos de los fragmentos de código de IntelliSense.

<Code Language="Language"
    Kind="method body/method decl/type decl/page/file/any"
    Delimiter="Delimiter">
    Code to insert
</Code>

Atributos y elementos

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
Delimiter	Atributo opcional. Especifica el delimitador utilizado para describir los literales y objetos en el código. De manera predeterminada, el delimitador es $.
Kind	Atributo opcional. Especifica el tipo de código que contiene el fragmento de código y, por consiguiente, la ubicación en la que debe insertarse un fragmento de código para que se compile. Los valores disponibles son method body, method decl, type decl, file y any. Para obtener más información, vea la sección el "Atributo Kind" en la tabla siguiente.
Language	Atributo necesario. Especifica el lenguaje del fragmento de código. Los valores disponibles son VB, CSharp o XML. Para obtener más información, vea la sección el "Atributo Language" en la tabla siguiente. Nota El esquema de fragmento de código de Intellisense no admite C++.

Delimiter

Atributo opcional.

Especifica el delimitador utilizado para describir los literales y objetos en el código. De manera predeterminada, el delimitador es $.

Kind

Atributo opcional.

Especifica el tipo de código que contiene el fragmento de código y, por consiguiente, la ubicación en la que debe insertarse un fragmento de código para que se compile. Los valores disponibles son method body, method decl, type decl, file y any. Para obtener más información, vea la sección el "Atributo Kind" en la tabla siguiente.

Language

Atributo necesario.

Especifica el lenguaje del fragmento de código. Los valores disponibles son VB, CSharp o XML. Para obtener más información, vea la sección el "Atributo Language" en la tabla siguiente.

Nota El esquema de fragmento de código de Intellisense no admite C++.

Atributo Kind

Valor	Descripción
method body	Especifica que el fragmento de código es un cuerpo de método y, por consiguiente, se debe insertar dentro de una declaración de método.
method decl	Especifica que el fragmento de código es un método y, por consiguiente, se debe insertar dentro de una clase o módulo.
type decl	Especifica que el fragmento de código es un tipo y, por consiguiente, se debe insertar dentro de una clase, módulo o espacio de nombres.
file	Especifica que el fragmento es un archivo de código completo. Estos fragmentos de código se pueden insertar solos en un archivo de código o dentro de un espacio de nombres.
any	Especifica que el fragmento se puede insertar en cualquier parte. Esta etiqueta se utiliza para fragmentos de código que son independientes del contexto, como los comentarios.

Atributo Language

Valor	Descripción
VB	Identifica un fragmento de código de Visual Basic.
CSharp	Identifica un fragmento de código de Visual C#.
XML	Identifica un fragmento de código XML.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
Snippet	Contiene las referencias, las importaciones, las declaraciones y el código para el fragmento de código.

Valor de texto

Se requiere un valor de texto.

Este texto especifica el código, junto con los literales y objetos, que se pueden utilizar cuando este fragmento de código se inserta en un proyecto.

Comentarios

Se pueden usar dos palabras reservadas en el texto del elemento Code: $end$ y $selected$. $end$ marca la ubicación en que colocar el cursor después de insertar el fragmento de código. $selected$ representa texto seleccionado en el documento que se insertará en el fragmento de código cuando se invoque. Por ejemplo, si tuviera:

$selected$ is a great color. I love $selected$.

y la palabra que "Blue" estuviera seleccionada al invocar la plantilla, obtendría:

Blue is a great color. I love Blue.

Todas las demás palabras clave $ se definen dinámicamente en las etiquetas <Object> y <Literal>.

Ejemplo

El elemento Code del fragmento de código siguiente muestra cómo escribir un fragmento de código Visual C# que crea un objeto SqlDataAdapter. Al literal y objeto definidos en el elemento Declarations se hace referencia en el elemento Code por el valor del elemento ID correspondiente. En este ejemplo, al literal se hace referencia como $SQL$ y al objeto se hace referencia como $Connection$.

<CodeSnippets xmlns="https://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
        <Header>
            <Title>Create a data adapter</Title>
            <Description>Creates a SqlDataAdapter object.</Description>
            <Author>Microsoft Corporation</Author>
            <Shortcut>createadapter</Shortcut>
        </Header>
        <Snippet>
            <Declarations>
                <Literal>
                    <ID>SQL</ID>
                    <ToolTip>Replace with a SQL connection string.</ToolTip>
                    <Default>"SQL connection string"</Default>
                </Literal>
                <Object>
                    <ID>Connection</ID>
                    <Type>System.Data.SqlClient.SqlConnection</Type>
                    <ToolTip>Replace with a connection object in your application.</ToolTip>
                    <Default>dcConnection</Default>
                </Object>
            </Declarations>
            <Code Language="CSharp">
                <![CDATA[
                    daCustomers = new SqlClient.SqlDataAdapter();
                    selectCommand = new SqlClient.SqlCommand($SQL$);
                    daCustomers.SelectCommand = selectCommand;
                    daCustomers.SelectCommand.Connection = $Connection$;
                ]]>
            </Code>
        </Snippet>
    </CodeSnippet>
</CodeSnippets>

Vea también

Conceptos

Referencia de esquemas de fragmentos de código

Compartir a través de