Elemento Object (frammenti di codice IntelliSense)

  • Articolo

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

Nelle sezioni seguenti vengono illustrati 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.

Funzione

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.

Descrizione

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

Dichiarazioni

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