C# 程式碼片段

在 Visual Studio 中，您可以使用代碼段將常用的程式代碼新增至 C# 程式代碼檔案。 程式碼片段可以更快速、更輕鬆且更可靠地撰寫程式碼。

擴充 代碼段會在指定的插入點新增。 環繞式 代碼段會在選取的程式代碼周圍新增，而且僅適用於C# 和C++。 如需如何使用代碼段插入或包圍程式代碼的指示，請參閱 代碼段。

代碼段參考

代碼段在 C# 和 C++ 中的運作方式大致相同，但預設代碼段集不同。 根據預設，Visual Studio 會包含下列 C# 代碼段：

C# 代碼段函式

函式指定於程式碼片段的 Function 項目中。 下表描述可用於 Function C# 代碼段中 元素的三個函式。

GenerateSwitchCases 範例

下列範例示範如何使用 GenerateSwitchCases 函式。 當您插入此代碼段並將列舉輸入常 $switch_on$ 值時，常 $cases$ 值會產生 case 列舉中每個值的語句。

<CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
        <Header>
            <Title>switch</Title>
            <Shortcut>switch</Shortcut>
            <Description>Code snippet for switch statement</Description>
            <Author>Microsoft Corporation</Author>
            <SnippetTypes>
                <SnippetType>Expansion</SnippetType>
            </SnippetTypes>
        </Header>
        <Snippet>
            <Declarations>
                <Literal>
                    <ID>expression</ID>
                    <ToolTip>Expression to switch on</ToolTip>
                    <Default>switch_on</Default>
                </Literal>
                <Literal Editable="false">
                    <ID>cases</ID>
                    <Function>GenerateSwitchCases($expression$)</Function>
                    <Default>default:</Default>
                </Literal>
            </Declarations>
            <Code Language="csharp">
                <![CDATA[
                    switch ($expression$)
                    {
                        $cases$
                    }
                ]]>
            </Code>
        </Snippet>
    </CodeSnippet>
</CodeSnippets>

ClassName 範例

下列範例示範如何使用 ClassName 函式。 當您插入此代碼段時，常 $classname$ 值會取代為程式代碼檔中該位置的封入類別名稱。

<CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
        <Header>
            <Title>Common constructor pattern</Title>
            <Shortcut>ctor</Shortcut>
            <Description>Code Snippet for a constructor</Description>
            <Author>Microsoft Corporation</Author>
            <SnippetTypes>
                <SnippetType>Expansion</SnippetType>
            </SnippetTypes>
        </Header>
        <Snippet>
            <Declarations>
                <Literal>
                    <ID>type</ID>
                    <Default>int</Default>
                </Literal>
                <Literal>
                    <ID>name</ID>
                    <Default>field</Default>
                </Literal>
                <Literal default="true" Editable="false">
                    <ID>classname</ID>
                    <ToolTip>Class name</ToolTip>
                    <Function>ClassName()</Function>
                    <Default>ClassNamePlaceholder</Default>
                </Literal>
            </Declarations>
            <Code Language="csharp" Format="CData">
                <![CDATA[
                    public $classname$ ($type$ $name$)
                    {
                        this._$name$ = $name$;
                    }
                    private $type$ _$name$;
                ]]>
            </Code>
        </Snippet>
    </CodeSnippet>
</CodeSnippets>

SimpleTypeName 範例

此範例示範如何使用 SimpleTypeName 函式。 當您將此代碼段插入程式碼檔案時， $SystemConsole$ 常值會取代為您叫用代碼段內容中類型的最簡單形式 Console 。

<CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
        <Header>
            <Title>Console_WriteLine</Title>
            <Shortcut>cw</Shortcut>
            <Description>Code snippet for Console.WriteLine</Description>
            <Author>Microsoft Corporation</Author>
            <SnippetTypes>
                <SnippetType>Expansion</SnippetType>
            </SnippetTypes>
        </Header>
        <Snippet>
            <Declarations>
                <Literal Editable="false">
                    <ID>SystemConsole</ID>
                    <Function>SimpleTypeName(global::System.Console)</Function>
                </Literal>
            </Declarations>
            <Code Language="csharp">
                <![CDATA[
                    $SystemConsole$.WriteLine();
                ]]>
            </Code>
        </Snippet>
    </CodeSnippet>
</CodeSnippets>

相關內容

• 程式碼片段
• 程式碼片段結構描述參考
• 範本參數
• 逐步解說：在 Visual Studio 中建立程式碼片段