共用方式為

Literal 項目 (IntelliSense 程式碼片段)

  • 發行項

定義可以編輯的程式碼片段的常值。

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

屬性和項目

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

屬性

屬性

描述

可以編輯

選擇性 Boolean 屬性。

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

子項目

項目

描述

預設

必要項目。

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

Function

選擇性項目。

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

ID

必要項目。

指定常值的唯一識別項。 Literal 項目中必定正好有一個 ID 項目。

工具提示

選擇性項目。

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

父項目

項目

描述

宣告

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

備註

Literal 項目是用以辨認整個包含在程式碼片段中一小段程式碼的取代，但有可能會在插入程式碼後加以自訂。 例如，常值字串、數值以及一些變數名稱應該宣告成常值。

常值和物件不能包含值為 selected 或 end 的 ID 項目。 $selected$ 值代表在文件中選取的文字，這些文字被叫用時將插入到程式碼片段中。 $end$ 會標記將程式碼片段插入後，放置游標的位置。

範例

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

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

請參閱

概念

程式碼片段結構描述參考