Elemento Literal (frammenti di codice IntelliSense)

Aggiornamento: novembre 2007

Definisce i valori letterali del frammento di codice che è possibile modificare.

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

Attributi ed elementi

Le seguenti sezioni illustrano attributi, elementi figlio e padre.

Attributi

Attributo	Descrizione
Editable	Attributo Boolean facoltativo. Specifica se il valore letterale può essere modificato dopo l'inserimento del frammento di codice. Il valore predefinito di questo attributo è true.

Elementi figlio

Elemento	Descrizione
Default	Elemento obbligatorio. Specifica il valore predefinito del valore letterale al momento dell'inserimento del frammento di codice. In un elemento Literal deve essere presente esattamente un elemento Default.
Function	Elemento facoltativo. Specifica una funzione da eseguire quando il valore letterale riceve lo stato attivo in Visual Studio. In un elemento Literal possono essere presenti zero elementi Function oppure uno.
ID	Elemento obbligatorio. Specifica un identificatore univoco per il valore letterale. In un elemento Literal deve essere presente esattamente un elemento ID.
Tooltip	Elemento facoltativo. Descrive l'utilizzo e il valore previsto del valore letterale. In un elemento Literal possono essere presenti zero elementi Tooltip oppure uno.

Elementi padre

Elemento	Descrizione
Declarations	Contiene i valori letterali e gli oggetti di un frammento di codice che è possibile modificare.

Note

L'elemento Literal viene utilizzato per identificare una sostituzione per una parte di codice che è interamente contenuta nel frammento, ma verrà probabilmente personalizzata dopo l'inserimento nel codice. È ad esempio opportuno dichiarare come valori letterali le stringhe letterali, i valori numerici e alcuni nomi di variabili.

I valori letterali e gli oggetti non possono contenere un elemento ID con valore end. $end$ è un valore riservato e viene utilizzato per contrassegnare il punto in cui posizionare il cursore dopo l'inserimento del frammento di codice.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come dichiarare un valore letterale con un elemento ID con valore SQL. Nell'elemento Code viene fatto riferimento al valore letterale utilizzando il delimitatore predefinito. In questo esempio viene fatto riferimento al valore letterale 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>

Vedere anche

Concetti

Riferimento dello schema dei frammenti di codice