Elemento de código (trechos de código de IntelliSense)

Artigo
03/22/2013

Fornece a um contêiner os blocos de código curtos de Trechos de Código IntelliSense.

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

Atributos e elementos

As seções a seguir descrevem elementos filho, atributos, e elementos pai.

Atributos

Atributo	Descrição
Delimiter	Atributo opcional. Especifica o delimitador usado para descrever os literais e os objetos no código.Por padrão, o delimitador é $.
Kind	Atributo opcional. Especifica o tipo de código que contém o trecho de código, e como consequência, o local em que um trecho de código deve ser inserido para o trecho de código para compilar.Os valores são disponíveis method body, method decl, type decl, file, e any.Para obter mais informações, consulte a seção “atributo amável” na tabela a seguir.
Language	Atributo necessário. Especifica a linguagem do trecho de código.Para obter mais informações, consulte a seção “atributo linguagem”.

Delimiter

Atributo opcional.

Especifica o delimitador usado para descrever os literais e os objetos no código.Por padrão, o delimitador é $.

Kind

Atributo opcional.

Especifica o tipo de código que contém o trecho de código, e como consequência, o local em que um trecho de código deve ser inserido para o trecho de código para compilar.Os valores são disponíveis method body, method decl, type decl, file, e any.Para obter mais informações, consulte a seção “atributo amável” na tabela a seguir.

Language

Atributo necessário.

Especifica a linguagem do trecho de código.Para obter mais informações, consulte a seção “atributo linguagem”.

Atributo amável

Valor	Descrição
method body	Especifica que o trecho de código é um corpo de método, e como consequência, deve ser inserido em uma declaração de método.
method decl	Especifica que o trecho de código é um método, e como consequência, deve ser inserido em uma classe ou um módulo.
type decl	Especifica que o trecho de código é um tipo, e como consequência, deve ser inserido em uma classe, módulo, ou espaço para nome.
file	Especifica que o trecho é um arquivo de código completo.Esses trechos de código podem ser inseridos em apenas um arquivo de código, ou dentro de um namespace.
any	Especifica que o trecho pode ser inserido em qualquer lugar.Essa marca é usada para os trechos de código que são independentes de contexto, como comentários.

Atributo de idioma

Valor	Descrição
VB	Identifica um trecho de código de Visual Basic .
CSharp	Identifica um trecho de código de Visual C# .
XML	Identifica um trecho de código XML.
CPP	Identifica o trecho de código de c++.
JavaScript	Identifica um trecho de código Javascript.
JScript	Identifica um trecho de código Jscript.
SQL	Identifica um trecho de código SQL.
HTML	Identifica um trecho de código HTML.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
Trecho	Contém as referências, as importações, as declarações, e o código para o trecho de código.

Valor de texto

Um valor de texto é necessário.

Esse texto especifica o código, juntamente com os literais e objetos, que você pode usar quando esse trecho de código é inserido em um projeto.

Comentários

Duas palavras reservadas estão disponíveis para uso em texto do elemento de Code : $end$ e $selected$.$end$ marca o local para colocar o cursor após o trecho de código é inserido.$selected$ representa o texto selecionado no documento que deve ser inserido no trecho de código em que é chamado.Por exemplo, se você tivesse:

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

e a palavra “blue” foram selecionadas quando você invocou o modelo, você obteriam:

Blue is a great color. I love Blue.

Todos outros palavra-chave de $ são definidas dinamicamente nas marcas de <Literal> e de <Object> .

Exemplo

O elemento de Code de trecho de código a seguir mostra como escrever um trecho de código de Visual C# que cria SqlDataAdapter.O literal e o objeto definidos no elemento de Declarations são referenciados no elemento de Code pelo valor do elemento de ID .Nesse exemplo, o literal é referenciado como $SQL$ e o objeto são referenciados 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>

Consulte também

Conceitos

Referência de esquema de trechos de código

Compartilhar via