Elemento Code (frammenti di codice IntelliSense)

Articolo
08/11/2011

Fornisce un contenitore per i brevi blocchi di codice dei frammenti di codice IntelliSense.

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attribute	Oggetto di descrizione
Delimiter	Attributo facoltativo. Specifica il delimitatore utilizzato per descrivere i valori letterali e gli oggetti nel codice. Per impostazione predefinita, il delimitatore è $.
Kind	Attributo facoltativo. Specifica il tipo di codice contenuto nel frammento e pertanto la posizione in cui un frammento di codice deve essere inserito per la relativa compilazione. I valori disponibili sono method body, method decl, type decl, file e any. Per ulteriori informazioni, vedere la sezione "Attributo Kind" nella tabella riportata di seguito.
Language	Attributo obbligatorio. Specifica il linguaggio del frammento di codice. I valori disponibili sono VB, CSharp o XML. Per ulteriori informazioni, vedere la sezione "Attributo Language" nella tabella riportata di seguito. Nota I frammenti di codice IntelliSense non supportano C++.

Delimiter

Attributo facoltativo.

Specifica il delimitatore utilizzato per descrivere i valori letterali e gli oggetti nel codice. Per impostazione predefinita, il delimitatore è $.

Kind

Attributo facoltativo.

Specifica il tipo di codice contenuto nel frammento e pertanto la posizione in cui un frammento di codice deve essere inserito per la relativa compilazione. I valori disponibili sono method body, method decl, type decl, file e any. Per ulteriori informazioni, vedere la sezione "Attributo Kind" nella tabella riportata di seguito.

Language

Attributo obbligatorio.

Specifica il linguaggio del frammento di codice. I valori disponibili sono VB, CSharp o XML. Per ulteriori informazioni, vedere la sezione "Attributo Language" nella tabella riportata di seguito.

Nota I frammenti di codice IntelliSense non supportano C++.

Attributo Kind

Value	Oggetto di descrizione
method body	Specifica che il frammento di codice è il corpo di un metodo e deve pertanto essere inserito all'interno di una dichiarazione di metodo.
method decl	Specifica che il frammento di codice è un metodo e deve pertanto essere inserito all'interno di una classe o un modulo.
type decl	Specifica che il frammento di codice è un tipo e deve pertanto essere inserito all'interno di una classe, un modulo o uno spazio dei nomi.
file	Specifica che il frammento è un file di codice completo. Questi frammenti di codice possono essere inseriti autonomamente in un file di codice o all'interno di uno spazio dei nomi.
any	Specifica che il frammento può essere inserito in qualsiasi posizione. Questo tag viene utilizzato per frammenti di codice indipendenti dal contesto, ad esempio commenti.

Attributo Language

Value	Oggetto di descrizione
VB	Identifica un frammento di codice Visual Basic.
CSharp	Identifica un frammento di codice Visual C#.
XML	Identifica un frammento di codice XML.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Oggetto di descrizione
Snippet	Contiene i riferimenti, gli elementi importati, le dichiarazioni e il codice del frammento di codice.

Valore di testo

È necessario specificare un valore di testo.

Tale testo specifica il codice, con i valori letterali e gli oggetti, che è possibile utilizzare in caso di inserimento di questo frammento di codice in un progetto.

Note

Due parole riservate sono disponibili per l'uso nel testo dell'elemento Code: $end$ e $selected$. $end$ contrassegna il punto in cui posizionare il cursore dopo l'inserimento del frammento di codice. $selected$ rappresenta il testo selezionato nel documento da inserire nel frammento di codice quando viene chiamato. Ad esempio:

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

e fosse stata selezionata la parola "Blu" al momento della chiamata al modello, si otterrebbe:

Blue is a great color. I love Blue.

Tutte le altre parole chiave $ vengono definite in modo dinamico nei tag <Literal> e <Object>.

Esempio

Nel frammento di codice riportato di seguito, l'elemento Code illustra come scrivere un frammento di codice Visual C# con cui viene creato un oggetto SqlDataAdapter. Al valore letterale e all'oggetto definiti nell'elemento Declarations viene fatto riferimento nell'elemento Code mediante il valore dell'elemento ID. In questo esempio viene fatto riferimento al valore letterale con $SQL$ e all'oggetto con $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>

Vedere anche

Concetti

Riferimento dello schema dei frammenti di codice

Condividi tramite