共用方式為

Code 項目 (IntelliSense 程式碼片段)

  • 發行項

提供容器 (Container) 供 IntelliSense 程式碼片段的簡短程式碼區塊使用。

<Code Language="Language"
    Kind="method body/method decl/type decl/page/file/any"
    Delimiter="Delimiter">
    Code to insert
</Code>

屬性和項目

下列各節將說明屬性、子項目和父項目。

屬性

屬性

描述

Delimiter

選擇性屬性。

指定用以描述程式碼中之常值 (Literal) 和物件的分隔符號。 分隔符號預設為 $。

Kind

選擇性屬性。

指定程式碼片段包含的程式碼種類，以及程式碼片段必須插入以供編譯的位置。 可用的值包括 method body、method decl、type decl、file 及 any。 如需詳細資訊，請參閱下表的＜類型屬性＞章節。

Language

必要屬性。

指定程式碼片段的語言。 可用的值為 VB、CSharp 或 XML。 如需詳細資訊，請參閱下表的＜語言屬性＞章節。

注意：Intellisense 程式碼片段結構描述不支援 C++。

類型屬性

值

描述

method body

指定程式碼片段為方法主體，因此必須在方法宣告中插入程式碼片段。

method decl

指定程式碼片段為方法，因此必須在類別或模組中插入程式碼片段。

type decl

指定程式碼片段為類型，因此必須在類別 (Class)、模組或命名空間中插入程式碼片段。

file

指定程式碼片段為完整的程式碼檔。 這些程式碼片段可以單獨插入程式碼檔案中或命名空間裡。

any

指定程式碼片段可以插入任何位置。 這個標記可用於與上下文無關的程式碼片段，例如註解。

語言屬性

值

描述

VB

辨認 Visual Basic 程式碼片段。

CSharp

辨認 Visual C# 程式碼片段。

XML

辨認 XML 程式碼片段。

子項目

無。

父項目

項目

描述

Snippet

包含該程式碼片段的參考、匯入、宣告和程式碼。

文字值

需要文字值。

此文字指定程式碼以及常值和物件，在將此程式碼片段插入專案時就可以使用它們。

備註

Code 項目的文字可以使用兩個保留字：$end$ 和 $selected$。 $end$ 會標記將程式碼片段插入後，放置游標的位置。 $selected$ 表示在文件中選取的文字，將會在被叫用時插入到程式碼片段中。。 例如，如果您有：

$selected$ is a great color. I love $selected$.

當您叫用範本時選取的文字是 "Blue"，就會得到：

Blue is a great color. I love Blue.

所有其他 $ 關鍵字會動態定義於 <Literal> 和 <Object> 標記中。

範例

下列程式碼片段的 Code 項目會示範如何撰寫 Visual C# 程式碼片段以建立 SqlDataAdapter。 在 Code 項目中 Declarations 項目內所定義的常值和物件由其 ID 項目的值所參考。 在這個範例中，是以 $SQL$ 來參考常值並以 $Connection$ 參考物件。

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

請參閱

概念

程式碼片段結構描述參考