Elemento Literal (frammenti di codice IntelliSense)

  • Articolo

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

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

Attributi

Attribute

Oggetto di 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

Oggetto di 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.

Funzione

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.

Descrizione

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

Oggetto di descrizione

Dichiarazioni

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 di selected o end. Il valore $selected$ rappresenta il testo selezionato nel documento da inserire nel frammento di codice quando viene richiamato. $end$ contrassegna 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