Literal 項目 (IntelliSense 程式碼片段)
更新:2007 年 11 月
定義可以編輯的程式碼片段的常值。
<Literal Editable="true/false"> <ID>... </ID> <ToolTip>... </ToolTip> <Default>... </Default> <Function>... </Function> </Literal>
屬性和項目
下列章節將說明屬性 (Attribute)、子項目和父項目。
屬性
屬性 |
描述 |
---|---|
Editable |
選擇性的 Boolean 屬性。 指定您在插入程式碼編輯器後是否可以編輯常值。此屬性的預設值為 true。 |
子項目
項目 |
描述 |
---|---|
必要項目。 當您插入程式碼片段時,指定常值的預設值。Literal 項目中必定正好有一個 Default 項目。 |
|
選擇性項目。 指定常值擷取 Visual Studio 中的焦點時要執行的函式。Literal 項目中可能有零個或一個 Function 項目。 |
|
必要項目。 指定常值的唯一識別項。Literal 項目中必定正好有一個 ID 項目。 |
|
選擇性項目。 描述常值需要的值和使用方式。Literal 項目中可能有零個或一個 Tooltip 項目。 |
父項目
項目 |
描述 |
---|---|
包含可以編輯之程式碼片段的常值和物件。 |
備註
Literal 項目是用以辨認整個包含在程式碼片段中一小段程式碼的取代,但有可能會在插入程式碼後加以自訂。例如,常值字串、數值以及一些變數名稱應該宣告成常值。
常值和物件不能包含值為 end 的 ID 項目。已保留 $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>