代码片段架构参考(四)

SnippetType 元素

指定 Visual Studio 如何添加代码片段。

<SnippetType>
    SurroundsWith/Expansion
</SnippetType>
父元素描述
SnippetTypes 元素对 SnippetType 元素进行分组。

该值必须是以下值之一:

说明
Expansion允许将代码片段插入游标。
Refactoring指定在 C# 重构期间使用代码片段。 Refactoring 不能在自定义代码片段中使用。
SurroundsWith允许将代码片段放在所选代码块周围。

SnippetTypes 元素

对单个 SnippetType 元素进行分组。 SnippetTypes如果元素不存在,则可以在光标处插入代码片段或放置在所选代码周围。

<SnippetTypes>
    <SnippetType>... </SnippetType>
    <SnippetType>... </SnippetType>
</SnippetTypes>
子元素描述
SnippetType 元素可选元素。 指定 Visual Studio 如何将代码段插入到代码中。 SnippetType 元素中可能有零个或零个以上的 SnippetTypes 元素。


父元素描述
Header 元素指定有关代码段的常规信息。

Title 元素

指定代码段的标题。 代码片段元素中Title存储的游戏显示在代码片段选取器中,并在代码片段管理器显示为代码片段的名称。

<ToolTip>
    ToolTip description
</ToolTip>
父元素描述
Header 元素指定有关代码段的常规信息。

需要一个文本值。 此文本指定代码段的标题。

ToolTip 元素

描述代码片段中文本或对象的预期值和用法。 将代码片段插入项目中时,Visual Studio 会在工具提示中显示此信息。 插入代码片段后,鼠标悬停在文本或对象上时,工具提示也会显示。

<Type>
    Type
</Type>


父元素描述
Literal 元素定义代码段的可编辑文本字段。
Object 元素定义代码段的可编辑对象字段。

需要一个文本值。 此文本指定要与代码段中的对象或文本关联的工具提示说明。

Type 元素

指定对象的类型。 该 Object 元素标识代码片段需要但可能在代码片段本身之外定义的项。 例如,Windows 窗体控件、ASP.NET 控件、对象实例以及类型实例应声明为对象。 对象声明需要指定一个类型,该类型是使用元素完成的 Type 。

<Type>
    Type
</Type>


父元素描述
Object 元素定义代码段的可编辑对象字段。

需要一个文本值。 此文本指定对象的类型。 例如:

<Type>System.Data.SqlClient.SqlConnection</Type>

Url 元素

指定一个 URL,它提供有关所引用程序集的详细信息。

 备注

仅 Visual Basic 项目支持该 Url 元素。

<Url>
    www.microsoft.com
</Url>

父元素描述
Reference 元素指定代码段所需的程序集引用。

需要一个文本值。 此文本指定包含有关所引用程序集的详细信息的 URL。 当无法将引用添加到项目时,将显示此 URL。