共用方式為

Object 項目 (IntelliSense 程式碼片段)

  • 發行項

更新：2007 年 11 月

定義可以編輯之程式碼片段的物件。

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

屬性和項目

下列章節將說明屬性 (Attribute)、子項目和父項目。

屬性

項目

描述

Editable

選擇性的 Boolean 屬性。

指定在插入程式碼編輯器後是否可以編輯物件。此屬性的預設值為 true。

子項目

項目

描述

Default

必要項目。

當您插入程式碼片段時，指定物件的預設值。Object 項目中必定正好有一個 Default 項目。

Function

選擇性項目。

指定物件擷取 Visual Studio 中的焦點時要執行的函式。Object 項目中可能有零個或一個 Function 項目。

ID

必要項目。

指定物件的唯一識別項。Object 項目中必須正好有一個 ID 項目。

Tooltip

選擇性項目。

描述物件需要的值和使用方式。Object 項目中可能有零或一個 Tooltip 項目。

Type

必要項目。

指定物件的型別。Object 項目中必須正好有一個 Type 項目。

父項目

項目

描述

Declarations

包含可以編輯的程式碼片段中所含的常值和物件。

備註

Object 項目是用以識別程式碼片段所需的項目，但有可能定義在程式碼片段本身的外面。例如，Windows Form 控制項、ASP.NET 控制項、物件執行個體以及型別執行個體應該宣告成物件。物件宣告需要指定型別，這是透過 Type 項目來完成。

範例

下例程式碼範例會示範如何使用 Connection 的 ID 項目值宣告 SqlConnection 物件。該物件是使用預設的分隔符號在 Code 項目中被參考。在這個範例中，是以 $Connection$ 來參考物件。

常值和物件不能包含值為 end 的 ID 項目。已保留 $end$ 值，並用來在插入程式碼片段以後，標示放置游標的位置。

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

請參閱

工作

HOW TO：建立具有取代物件的新程式碼片段

概念

程式碼片段結構描述參考