HOW TO：建立基本的程式碼片段

發行項
08/21/2008

更新：2007 年 11 月

IntelliSense 程式碼片段是副檔名為 .snippet 的 XML 檔，它們會遵守 IntelliSense 程式碼片段 XML 結構描述。在這個主題中，您將建立顯示訊息方塊的基本程式碼片段。如需程式碼片段 XML 結構描述的詳細資訊，請參閱程式碼片段結構描述參考。

建立 .snippet 檔

您必須先建立具有 .snippet 副檔名的 XML 檔，才能開始撰寫程式碼片段。

若要建立 .snippet 檔

在 [檔案] 功能表上，按一下 [新增]，然後再按一下 [檔案]。
按一下 [XML 檔]，然後再按一下 [開啟]。
在 [檔案] 功能表上，按一下 [儲存 <XMLFileName>]。
在 [存檔類型] 方塊裡，選取 [所有檔案 (*.*)]。
在 [檔名] 方塊中輸入副檔名為 .snippet 的檔案名稱。
按一下 [儲存]。

撰寫程式碼

有了 XML 檔之後，您現在需要撰寫構成程式碼片段的 XML 程式碼。如需下列範例中所使用之任一 XML 項目的詳細資訊，請參閱程式碼片段結構描述參考。

若要撰寫程式碼片段的程式碼

請在 XML 的自動產生行底下，加入具有適當 xmlns 屬性值的 CodeSnippets 項目以及 CodeSnippet 項目，以建立個別程式碼片段。例如：
```
<CodeSnippets xmlns="https://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
```

將標頭區段加入至程式碼片段。例如：

<Header>
    <Title>
        My Snippet
    </Title>
</Header>

加入定義程式碼片段本身的項目。在下列範例中，程式碼片段的語言是 Visual Basic。
```
<Snippet>
    <Code Language="VB">

    </Code>
</Snippet>
```
注意事項：

Language 屬性也接受 CSharp、VJSharp 和 XML 等值。如需詳細資訊，請參閱Code 項目 (IntelliSense 程式碼片段)。
請在 Code 項目內加入程式碼片段的 Visual Basic 程式碼。所有片段程式碼必須置於 <![CDATA[ 和 ]]> 括號之間。下列範例中，將插入的程式碼是 MessageBox.Show("Hello World")。
```
<Code Language="VB">
    <![CDATA[MessageBox.Show("Hello World")]]>
</Code>
```
請在 Snippet 項目內加入 References 項目和所有必要子項目，這些子項目將在插入程式碼片段時加入參考至專案。在這個範例中，此程式碼片段會在將它插入時加入參考至 System.Windows.Forms.dll。

注意事項：

只有 Visual Basic 程式碼片段支援 References 區段。其他語言的程式碼片段必須以手動方式加入正確的參考。
```
<Snippet>
    <References>
        <Reference>
            <Assembly>System.Windows.Forms.dll</Assembly>
        </Reference>
    </References>
    <Code Language="VB">
        <![CDATA[MessageBox.Show("Hello World")]]>
    </Code>
</Snippet>
```

注意事項：
Language 屬性也接受 CSharp、VJSharp 和 XML 等值。如需詳細資訊，請參閱Code 項目 (IntelliSense 程式碼片段)。

注意事項：
只有 Visual Basic 程式碼片段支援 References 區段。其他語言的程式碼片段必須以手動方式加入正確的參考。

您現在即可依照 HOW TO：管理程式碼片段和 HOW TO：插入 IntelliSense 程式碼片段中的程序，在 Visual Studio 2005 中使用這個 IntelliSense 程式碼片段。

範例

這個範例包含在上述步驟中建立的整個 IntelliSense 程式碼片段。

<CodeSnippets
    xmlns="https://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
        <Header>
            <Title>
                My Snippet
            </Title>
        </Header>
        <Snippet>
            <References>
                <Reference>
                    <Assembly>System.Windows.Forms.dll</Assembly>
                </Reference>
            </References>
            <Code Language="VB">
                <![CDATA[MessageBox.Show("Hello World")]]>
            </Code>
        </Snippet>
    </CodeSnippet>
</CodeSnippets>

這個範例包含在上述步驟中建立的 Visual C# 版本之 IntelliSense 程式碼片段。Visual C# 程式碼片段並不支援 References 區段，因此 System.Windows.Forms.dll 的參考必須以手動方式加入至專案。

<CodeSnippets
    xmlns="https://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
        <Header>
            <Title>
                My Snippet
            </Title>
        </Header>
        <Snippet>
            <Code Language="CSharp">
                <![CDATA[MessageBox.Show("Hello World");]]>
            </Code>
        </Snippet>
    </CodeSnippet>
</CodeSnippets>