Object (Elemento, fragmentos de código IntelliSense)

Actualización: noviembre 2007

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

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

Atributos y elementos

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

Atributos

Elemento	Descripción
Editable	Atributo Boolean opcional. Especifica si se puede editar o no el objeto tras 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 objeto cuando se inserta el fragmento de código. Debe haber exactamente un elemento Default en un elemento Object.
Function	Elemento opcional. Especifica una función que ejecutar cuando el objeto recibe el foco en Visual Studio. Puede haber cero o un elemento Function en un elemento Object.
ID	Elemento necesario. Especifica un identificador único para el objeto. Debe haber exactamente un elemento ID en un elemento Object.
Tooltip	Elemento opcional. Describe el valor esperado y uso del objeto. Puede haber cero o más elementos Tooltip en un elemento Object.
Type	Elemento necesario. Especifica el tipo de objeto. Debe haber exactamente un elemento Type en un elemento Object.

Elementos primarios

Elemento	Descripción
Declaraciones	Contiene los literales y objetos que constituyen las partes de un fragmento de código que se pueden editar.

Comentarios

El elemento Object se utiliza para identificar un elemento necesario para el fragmento de código, pero que probablemente se defina fuera del propio fragmento. Por ejemplo, los controles de Windows Forms, los controles de ASP.NET, las instancias de objeto y las instancias de tipo se deberían declarar como objetos. Las declaraciones de objeto requieren que se especifique un tipo, lo que se hace mediante el elemento Type.

Ejemplo

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

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.

<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

Tareas

Cómo: Crear un nuevo fragmento de código con sustituciones

Conceptos

Referencia de esquemas de fragmentos de código