[转]Visual Studio技巧之打造拥有自己标识的代码模板

可能经过很多博客的介绍，大家都知道代码段的使用，使用代码段可以很方便地生成一些常用的代码格式，确实对我们开发很方便。在团队开发中或者在某些情况下我们经常可能还会希望使用Visual Studio生成的代码自动带有一些信息，比如代码文件的创建时间、代码的说明及对命名空间的引用等等，实际上这个功能经周公证实在Visual Studio2005以上版本中就支持了。

下面以周公的本本的具体情况为例来加以说明，在周公的DELL 1425上系统是安装在C盘，在系统盘下同时安装了Visual Studio 2005和Visual Studio 2008两套Visual Studio，并且安装了正版的SQL Server 2005，因为系统盘经常在Windows XP和Windows 7之间切换并且还想在Windows XP和Windows 7之间共享某些个人配置，所以将我的文档目录设置到了系统最后的一个盘G盘上了，具体路径为G:\My Documents，如果不做特别配置应为C:\Documents and Settings\zhoufoxcn\My Documents，这一点尤其注意。

这里针对Visual Studio 2008来进行说明，首先我们打开C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE这个目录（如果使用Visual Studio 2005则对应的路径为C:\Program Files\Microsoft Visual Studio 8\Common7\IDE），可以看到如下的情况：

代码

using System;
using System.Collections.Generic;
$if$ ($targetframeworkversion$ == 3.5)using System.Linq;
$endif$using System.Text;

namespace $rootnamespace$
{
/// <summary>
/// 作者：zhoufoxcn
/// 时间：$time$
/// 公司:$registeredorganization$
/// 版权：$year$-2012
/// CLR版本：$clrversion$
/// 博客地址：http://blog.csdn.net/zhoufoxcn
/// $safeitemrootname$说明：本代码版权归周公所有，使用时必须带上周公博客地址
/// 唯一标识：$guid1$
/// </summary>
public class $safeitemrootname$
{
$safeitemrootname$()
{
}
}
}

保存class.cs，然后利用压缩软件将class.cs和刚刚从Class.zip中解压出来Class.vstemplate文件压缩为Class.zip文件（注意一定要压缩成zip文件而不是rar或者其它格式文件，WinRAR提供这种功能），然后替换原来的Class.zip文件。

好了，现在我们可以检验我们的成果了。随便打开一个项目，按照“添加”-“新建项”的步骤添加，在弹出的对话框中“我的模板”下选择“类”（因为我们刚刚改的就是我的模板中添加的类的模板），这时Visual Studio 2008按照模板生成的代码如下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace WCFClient
{
/// <summary>
/// 作者：zhoufoxcn
/// 时间：2010-6-20 9:39:04
/// 公司:www.netskycn.com
/// 版权：2010-2012
/// CLR版本：2.0.50727.3603
/// 博客地址：http://blog.csdn.net/zhoufoxcn
/// Class1说明：本代码版权归周公所有，使用时必须带上周公博客地址
/// 唯一标识：f5d4bfbe-accd-4d77-92b0-1407db616ae1
/// </summary>
public class Class1
{
Class1()
{
}
}
}

从
上面的例子可以看出选择我的模板的项就会按照预定好的格式生成代码，如果我们对项目中的代码有特殊格式要求的话，在这里统一定制非常方便，至少周公以后会
用这种模板来写公布在博客上的代码，因为周公注意到有很网站喜欢将别人博客上的文章中的链接信息和作者信息去掉，这事实上违反了作者的声明。有时间的话我
们可以针对每一个项更改出自己的模板。

上面我们仅仅演示了生成新文件的配置，其实我们还可以更改新生成项目的配置，按照前面的操作我们添加新项目时也有我的模板选项，如下图所示：



不过即使从我的模板中选择创建新项目也和系统中的项目一样，因为没有经过任何特殊配置。我们可以修改G:\My Documents\Visual Studio 2008\Templates\ProjectTemplates\CSharp下的项目模板，它们同样也是一个zip文件，比如我们想要统一程序集信息，可以修改这个zip文件中的assemblyinfo.cs文件的内容，这样就不用每次都手动去修改程序集信息了。

通过上面的步骤之后可以让我们很方便地定制了添加新项或者新项目的模板，这在公司中团队开发中还是相当有用的，也方便对代码文件的格式的统一。

需要说明的是在编辑模板时会看到一个形如$time$、$rootnamespace$之类的东西，这些算是生成模板时用到的变量吧，在编辑模板时可以使用哪些变量微软没有官方的资料，不过周公留意了一下，大概有如下：

Itemname

safeitemname

sateitemrootname

projectname

safeprojectname

rootnamespace

guid[1-10]

time

year

username

userdomain

machinename

clrversion

targetframeworkversion

registeredorganization

wizarddata

可能有些人对上面的变量名不是太理解，其实是有规律的，都是一到几个单词的全称，只不过没有遵循我们平常所说的Camel和Pascal命
名法则罢了（大家可以看的出不遵守命名法则确实难读多了），知道这个规律之后这些变量的用途大家都能顾名思义了，如果确实不能也能根据最终生成的代码推断
出它的用法的。此外，如果觉得每次都要从“我的模板下”选择很麻烦的话，可以用更改后自定义模板替换系统中的模板。在刚刚编辑模板时我们还看到了一些简单
逻辑，比如当使用的项目.NET Framework版本为3.5时会自动使用System.Linq命名空间，我们还可以模范系统模板中的逻辑增加更多更符合个人或者公司需要的逻辑。

周公

2010-06-20

转自：http://www.360doc.com/content/10/0925/12/1389945_56218377.shtml