Partilhar via


Elemento literal (trechos de código de IntelliSense)

Define os literais do trecho de código que pode ser editado.

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

Atributos e elementos

The following sections describe attributes, child elements, and parent elements.

Atributos

Attribute

Description

Editável

Opcional Boolean atributo.

Especifica se ou não é possível editar o literal depois de inserido o trecho de código. O valor padrão deste atributo é true.

Elementos filho

Element

Description

Default

Elemento necessário.

Especifica o valor do padrão do literal quando você inserir o trecho de código. Deve haver exatamente um Default elemento em um Literal elemento.

Function

Elemento opcional.

Especifica uma função a ser executada quando o literal recebe o foco em Visual Studio. Pode haver zero ou um Function elementos em um Literal elemento.

ID

Elemento necessário.

Especifica um identificador exclusivo para o literal. Deve haver exatamente um ID elemento em um Literal elemento.

Tooltip

Elemento opcional.

Descreve o valor esperado e o uso do literal. Pode haver zero ou um Tooltip elementos em um Literal elemento.

Elementos pai

Element

Description

Declarations

Contém os literais e os objetos de um trecho de código que pode ser editado.

Comentários

O Literal elemento é usado para identificar um substituto para um trecho de código que está inteiramente contido no trecho, mas provavelmente será personalizado depois que ele é inserido no código. Por exemplo, seqüências de caracteres literais, valores numéricos e alguns nomes de variáveis devem ser declarados como literais.

Literais e os objetos não podem conter um ID o elemento com um valor de selected ou end. O valor $selected$ representa o texto selecionado no documento que deve ser inserido o trecho de código quando ele é chamado. $end$marca o local para colocar o cursor após o trecho de código é inserido.

Exemplo

O exemplo de código a seguir mostra como declarar uma literal com um ID o valor do elemento de SQL. O literal é referenciado no Code elemento usando o delimitador padrão. Neste exemplo, o literal é referenciado com $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>

Consulte também

Conceitos

Referência de esquema de trechos de código