Literal (Elemento, fragmentos de código IntelliSense)

Actualización: noviembre 2007

Define los elementos Literal del fragmento de código que se pueden editar.

<Literal Editable="true/false">
   <ID>... </ID>
   <ToolTip>... </ToolTip>
   <Default>... </Default>
   <Function>... </Function>
</Literal>

Atributos y elementos

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

Atributos

Atributo	Descripción
Modificable	Atributo Boolean opcional. Especifica si se puede o no editar el literal después de insertar el fragmento de código. El valor predeterminado de este atributo es true.

Elementos secundarios

Elemento	Descripción
Default	Elemento necesario. Especifica el valor predeterminado del literal cuando inserta el fragmento de código. Debe haber exactamente un elemento Default en un elemento Literal.
Function	Elemento opcional. Especifica una función que ejecutar cuando el literal recibe el foco en Visual Studio. Puede haber cero o un elemento Function en un elemento Literal.
ID	Elemento necesario. Especifica un identificador único para el literal. Debe haber exactamente un elemento ID en un elemento Literal.
Tooltip	Elemento opcional. Describe el valor esperado y uso del literal. Puede haber cero o un elemento Tooltip en un elemento Literal.

Elementos primarios

Elemento	Descripción
Declaraciones	Contiene los literal y objetos de un fragmento de código que se pueden editar.

Comentarios

El elemento Literal se utiliza para identificar el reemplazo de una pieza de código que está incluida completamente en el fragmento, pero que es probable que se personalice tras insertarla en el código. Por ejemplo, las cadenas literales, los valores numéricos y algunos nombres de variable se deberían declarar como elementos literal.

Los literales y objetos no pueden contener un elemento ID con un valor de end. El valor $end$ es reservado y se utiliza para marcar la ubicación en que colocar el cursor después de insertar el fragmento de código.

Ejemplo

El ejemplo de código siguiente muestra cómo declarar un literal con un valor de elemento ID de SQL. Al literal se hace referencia en el elemento Code mediante el delimitador predeterminado. En este ejemplo, al literal se hace referencia con $SQL$.

<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