Elemento Object (frammenti di codice IntelliSense)

Aggiornamento: novembre 2007

Definisce gli oggetti del frammento di codice che è possibile modificare.

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

Attributi ed elementi

Le seguenti sezioni illustrano attributi, elementi figlio e padre.

Attributi

Elemento	Descrizione
Editable	Attributo Boolean facoltativo. Specifica se l'oggetto 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 dell'oggetto al momento dell'inserimento del frammento di codice. In un elemento Object deve essere presente esattamente un elemento Default.
Function	Elemento facoltativo. Specifica una funzione da eseguire quando l'oggetto riceve lo stato attivo in Visual Studio. In un elemento Object possono essere presenti zero elementi Function oppure uno.
ID	Elemento obbligatorio. Specifica un identificatore univoco per l'oggetto. In un elemento Object deve essere presente esattamente un elemento ID.
Tooltip	Elemento facoltativo. Descrive l'utilizzo e il valore previsto dell'oggetto. In un elemento Object possono essere presenti zero elementi Tooltip oppure uno.
Type	Elemento obbligatorio. Specifica il tipo dell'oggetto. In un elemento Object deve essere presente esattamente un elemento Type.

Elementi padre

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

Note

L'elemento Object viene utilizzato per identificare un elemento richiesto dal frammento di codice ma che viene probabilmente definito al di fuori del frammento stesso. È ad esempio opportuno dichiarare come oggetti i controlli Windows Form, i controlli ASP.NET, le istanze di oggetti e le istanze di tipi. Per le dichiarazioni di oggetti è necessario specificare un tipo, utilizzando l'elemento Type.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come dichiarare un oggetto SqlConnection con un elemento ID con valore Connection. Nell'elemento Code viene fatto riferimento all'oggetto utilizzando il delimitatore predefinito. In questo esempio, viene fatto riferimento all'oggetto con $Connection$.

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.

<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

Attività

Procedura: creare un nuovo frammento con sostituzioni

Concetti

Riferimento dello schema dei frammenti di codice