使用VS中的Code Snippet来提高开发效率 - 学IT网 xueit.com

来源：百度文库编辑：神马文学网时间：2024/04/29 14:33:27

使用VS中的Code Snippet来提高开发效率

时间:2009-2-17 23:46:14 来源:编辑整理作者:webmaster

前言
在谈谈VS中的模板中，我介绍了如何创建项目/项模板，这种方式可以在创建项目时省却不少重复性的工作，从而提高开发效率。在创建好了项目和文件后，就得开始具体的编码了，这时又有了新的重复性工作，就是需要经常编写一些类似或者说雷同的代码，我们需要一种方法将这些代码管理起来，减少重复输入。一个常见的例子，在使用for语句结构时，可能会有这样的代码：CodeCode highlightin

在谈谈VS中的模板中，我介绍了如何创建项目/项模板，这种方式可以在创建项目时省却不少重复性的工作，从而提高开发效率。在创建好了项目和文件后，就得开始具体的编码了，这时又有了新的重复性工作，就是需要经常编写一些类似或者说雷同的代码，我们需要一种方法将这些代码管理起来，减少重复输入。

一个常见的例子，在使用for语句结构时，可能会有这样的代码：

Code
int[] array = { 1, 2, 3, 4, 5 };
for (int i = 0; i < array.Length; i++)
{
Console.WriteLine(array[i]);
}

或者

Code
List names = new List { "Anders", "Bill", "Clark", "David"};
for (int i = 0; i < names.Count; i++)
{
    if (names[i].StartsWith("A"))
    {
        Console.WriteLine(names[i]);
    }
}

显然，这两个for循环的代码很相似：输入for，选择一个变量用作索引，该变量有个上限值，还有几个括号和分号。而且绝大多数的for循环都是如此，那么该如何减少重复输入呢？可以想到的一种方法是把一段for循环的代码保存在某个地方，比如一个文件内，在需要for的地方，拷贝进来，把变量名、初始值、上限修改一下就可以用了。

VS的开发者想的很周全，提供了CodeSnippet功能，从而实现了上面的想法。它保存了for循环代码的模板，然后给它一个快捷键for。现在在编辑器中（需要是C#文件），输入for，连续按两下Tab键，就会出现下面的代码：

不仅有了for的基本代码，还定位到了变量的名字处，如果需要可以修改变量名，假设改为index，后面的两个i会自动改为index，然后按Tab，光标会跳至下一个深色显示的地方，即length，这里可以修改index的上限，然后回车，光标会跳至for循环的代码体：

是不是很方便呢？还有很多其它Snippet，比如输入cw，按两下Tab就出来Console.WriteLine()。

很多时候，同样的功能在不同语言内的表现是不同的，所以CodeSnippet（以下简称Snippet）是特定于语言的，也就是说C#的Snippet不能用于VB.NET。VS2008中的Snippet支持C#、VB.NET、XML。

Snippet的管理

首先VS2008提供了很多内置的Snippet，另外我们也可以将自己编写的或者他人编写的导入VS中。通过菜单Tools ->Code Snippets Manager（或按Ctrl+K, Ctrl+B），打开Code Snippets Manager窗口：

可以看到上面的Language列表，现在选中的是C#。可以通过Import方式来导入新的Snippet。在使用NUnit时，由于测试代码的特点，会有很多重复输入，所以Scott Bellware提供了NUnit的Snippet，我把它放在自己的博客来了：BellwareNUnitSnippet。现在把包里的.snippet文件导入。

嗯，可以使用了。比如，输入tc，按两下Tab，出来的代码是这样的：

输入TestCase的名称，回车，这样就可以输入测试代码了。观察一下这个Snippet，它的变化之处只有一个，就是TestCase处。

接下来我们来分析一下Snippet文件的结构，这样才能编写自己的Snippet。

Snippet定义文件解析

下面来看看Snippet是如何实现的。根据上面tc的例子，我们可以猜想要存放Snippet，至少需要模板代码、占位符、语言类型、快捷键这几个关键信息，每个Snippet都是如此。事实上，VS把这些信息保存在XML文件中，这些信息都对应着某些节点，这个与上一篇里的模板清单文件类似。

存放Snippet的文件是XML文件，不过它的扩展名是.snippet。一个Snippet文件可以包含多个Snippet，就像上面的BellwareNUnit.snippet那样。它的基本结构如下：

XML Code

            Code Snippet for Debug.WriteLine method.
            dw
            Anders Cui

                                Debug.WriteLine(“Text”);
                ]]>

现在新建一个XML文件，输入上面的代码，这里我们的Snippet是输入Debug.WriteLine代码。该文件的根节点为CodeSnippets，可以包含多个节点。注意它的命名空间，有了这个，在VS内编辑时就方便多了。

重点关注<CodeSnippet>节点，它即表示一条Snippet。它必须包含一个FormatAttribute（老是看到Attribute和Property的讨论，故在此保留），用以表示Snippet版本。另外它必须包含两个子节点：<Header>和<Snippet>。

对于

节点，最重要的是Title和Shortcut，即Snippet的名称和快捷键；另外还有SnippetTypes，它可以包含若干个SnippetType节点，可有三种取值，Expansion、SurroundsWith、Refactoring。Expansion允许代码插入在光标处；SurroundsWith允许代码围绕在选中代码两边（就像#region那样）；Refactoring指定了在C#重构过程中所使用的Snippet，在自定义Snippet中不能使用。如果该值不做设置，则Snippet可以放在任何地方。

要了解

的更多信息，请参看这里。

对于节点，它是实现代码模板的地方。它包含四个子节点。

1、 <Code>节点

Delimiter：分隔符，默认值为$，后面你会看到它的用法。
Kind：Snippet的类型，比如方法体、方法声明、类型声明等。
Language：所适用的语言类型，如C#、VB.NET、XML。