Visual Studio 插件的开发（转）

原由

在作项目的时候，常常须要根据表结构create一些实体类，写多了，实在是以为无趣，因而就琢磨着作个代码生成工具。固然如今有不少现成的，拿来用就好，但是总想本身弄个出来玩玩，一来是当初用DataSet，VS能够根据一个xsd文件生成那么多代码，能够拖拖拽拽就搞定，一直没闹明白是怎么作的，不甘心，总想弄明白，二来，公司里，数据库的脚本大可能是根据一个xml配置文件生成的，这样，我拿到这个xml生成代码也是挺方便的。

学习

有了这个想法，可彻底没头绪该怎么开发VS add-in， 无奈，只能仰仗Google大神了，“VS 插件”， “自动代码生成 vs site:cnblogs.com” … 等等，一顿狂搜，了解到了相关的技术有：VS Add-in, CodeDom, T4, Template, Visual Designer, Domain-Specific Languages, Custom tools, etc.

VS Add-in: 可使用任何.Net语言开发VS的插件，能够操做开发环境中的任何元素：解决方案，项目，文件，菜单，Solution Explorer, Output window…

CodeDom: 代码文档对象模型。相似Xml的Dom操做，CodeDom将代码转换成一种数据结构，经过操做这种数据结构能够实现生成代码，修改代码，动态编译等等各类功能。

T4: Text Templating Transformation Toolkit, 经过模板加代码的方式产生代码，能够想象下aspx页面，里面有html代码，也有.Net代码，经过转换，最后呈现出html页面。

Template: 模板，在添加新项的时候，在对话框中的那些就是模板。

Visual Designer: 像类型化DataSet，它有一个可视化的编辑界面，经过拖拽，点几下鼠标等等操做就能够设计出咱们想要的DataSet类型。

Domain-Specific Languages: 特定领域模型语言,经过它，咱们能够设计出Visual Designer。

Custom Tools: 自定义工具，经过一个文件生成另外一个文件。

实践

CodeDom太复杂，用来生成代码若是杀鸡用牛刀，Visual Designer， Domain-Specific Languages，嗯，也用不到，暂时我不须要作个可视化的界面去设计个人代码，等我哪天要实现个相似类型化DataSet那样的插件的时候再考虑吧。去掉那些复杂的东西，我如今要用到的技术有：VS Add-in，用来实现VS的插件，使代码生成工具集成进VS；T4， 用来产生代码； Template，定义一个模板。

先说T4，看个简单的列子：

首先建立一个项目，而后添加新项，选择文本模板

文件里包含以下代码

<#@ template debug="false" hostspecific="false" language="C#" #> 
<#@ output extension=".txt" #>

在文本模板中，<#@ #>中是指令，定义了模板的一些行为，如第二行，output extension=”.txt”,意思是说，该模板最后转换生成的文件的后缀是.txt的。固然，我须要的代码文件，因此将其改成.cs便可。将文本修改为下面这个样子：

<#@ template debug="false" hostspecific="false" language="C#" #> 
<#@ output extension=".cs" #> 
using System;

namespace T4 
{ 
    public class T4Test 
    { 
    } 
}

保存后，能够看到Solution Explorer里面多了一个.cs文件

打开cs文件，能够看到里面包含以下代码，跟我在模板文件里的内容同样。

using System;

namespace T4 
{ 
    public class T4Test 
    { 
    } 
}

关于T4的语法，cnBlogs里有太多解释，这里就不更进一步的描述了。

但是，这样一个模板文件产生的代码是固定的，而我须要的是输入一段xml，根据xml来生成相应的代码文件。要使模板文件知道xml里的内容，则须要将其内容做为参数传递到模板里，这个时候就须要用到参数指令：

<#@ parameter type="" name="" #>

而后再将以前的模板修改成：

<#@ template debug="false" hostspecific="false" language="C#" #> 
<#@ output extension=".cs" #> 
<#@ parameter type="System.String" name="className" #> 
using System;

namespace T4 
{ 
    public class <#= className #> 
    { 
    } 
}

若是这个时候，点击保存，VS会提示你转换失败，由于输入的参数为空。这个时候，须要修改模板文件的属性，在自定义工具里，咱们能够看到显示的是TextTemplatingFileGenerator，它负责将模板文件转换成目标文件。可是在这里，我须要的是将模板转换成代码生成类，将该属性修改成：TextTemplatingFilePreprocessor。这个时候再保存，就会发现原来的cs文件里的内容变成了一段长的代码：

namespace Test 
{ 
    using System; 
    
    
    #line 1 "E:\My Files\Documents\Visual Studio 2010\Projects\MStarGATDataEntityGenerator\NUTest.GAT.Common\TextTemplate1.tt" 
    [System.CodeDom.Compiler.GeneratedCodeAttribute("Microsoft.VisualStudio.TextTemplating", "10.0.0.0")] 
    public partial class TextTemplate1 : TextTemplate1Base 
    {

… …

记得原来用VS2003的时候，尚未T4技术，那个时候也写了一个代码生成工具，那个幸苦啊，一行行的WriteLine，又要控制输出代码的缩进，长长的一大段代码。如今TextTemplatingFilePreprocessor工具将模板自动的生成了那个类，工做强度上轻松多了。在这个TextTemplate1类里有个TransformText的方法，调用它，就会根据模板输出代码。不过如今还不能直接去调用，不然仍是会出现跟使用TextTemplatingFileGenerator工具时同样的错误。由于，咱们仍是没有设置className变量的值。但是找遍整个TextTemplate1类，既没有在构造函数里发现参数能够设置，也没发现公共属性，也没方法，只有一个私有的_classNameField变量。好在生成的TextTemplate1类是partial的，咱们能够本身定义一个属性去设置className，而后再调用TransformText方法。好比设置className为“Table”，咱们将获得代码：

using System;

namespace T4 
{ 
    public class Table 
    { 
    } 
}

好了，到此，关于T4要用到的知识就这些了。

下面就是VS Add-in了。前面说了，我想当在VS里添加了一个新文件，而后将一段xml复制到文件里，而后保存，最后就能获得代码文件。前面T4已经能够帮助我实现生成代码文件，如今我须要的是可让我在保存文件的时候将文件的内容传递给TextTemplate1类，而后调用TransformText方法，而后将获得的代码内容保存到一个cs文件中，并添加到项目里。而这些工做就得依靠VS Add-in来帮我实现了。

首先，咱们须要添加一个VS Add-in的项目

找到Connect.cs文件，在OnConnection方法中，添加如下代码

DocumentEvents docMasterEvents = this.application.Events.get_DocumentEvents(null); 
docMasterEvents.DocumentSaved += new _dispDocumentEvents_DocumentSavedEventHandler( 
    docMasterEvents_DocumentSaved);

以及方法

void docMasterEvents_DocumentSaved(Document Document) 
{ 
    if (Document == null) return; 
    if(!Document.Name.ToLower().EndsWith(“.xml”)) return;

    TextTemplate1 gen = new TextTemplate1();

    gen.className = “Table”;

    string code = gen.TransformText();

    // todo: 将代码写入到文件里，并添加到项目中 
}

在上面的DocumentSaved方法里，若是发现文件后缀是xml的，就去调用模板。这里有个问题，那就是，会对全部的xml都去调用。但是在一个项目里总会有些其余的xml文件，这些文件是不须要转换的。固然能够对文件内容进行判断，再决定要不要调用模板，不过更简单的方法是用一个特殊的文件名，而不是用.xml。好比在个人项目里，我使用.msgatde做为文件名后缀。讲到这里，又该介绍下模板了，这里的模板是指添加新项时，那些可选择的项目。

为何要讲模板呢，原本实现这个代码自动生成的工具就是图个方便，可若是每次都要本身将新建的xml文件的后缀改为我本身定义的那个后缀，多麻烦，说不定还很容易写错。全部为了更一步简化操做，我打算定义一个模板，这样在添加新项的时候，就自动生成一个.msgatde后缀的文件。

一个模板里，通常会至少包含3个文件：

第一个，图标文件，在对话框里显示用的。

第二个，模板文件，添加新项后，VS会根据这个文件产生新的文件添加到项目中。

第三个，模板描述文件。

如今来看下第三个文件的内容：

其中ProjectItem那一段即定义了模板的行为：经过模板里的DataEntity.msgatde文件产生目标文件$fileinputname$.msgatde。

在这些文件编辑好后，须要将其打包成一个zip文件，并将其放置到$my documents$\Visual Studio 2010\Templates\ItemTemplates\Visual C#目录下。如今在选择添加新项，便可看到咱们定义的模板了。

ok，讲完了怎么定义一个模板，如今该接着讲VS Add-in了。在前面的DocumentSaved方法里尚未实现如何将生成的代码添加到项目里，如今接着说。

首先，须要将获得的代码保存到文件里，这里就有一个问题了，如何知道路径呢？在DocumentSaved方法中，有一个Document的参数，这个就是表示了当前的文档，Document有个属性ProjectItem，经过该属性能够获取到当前文件的路径：

string fullname = Document.ProjectItem.Properties.Item(“FullPath”).Value.ToString();

知道了路径，就容易多啦:

string codeFile = fullname.Repleace(“.msgatde”, “.cs”);

using(StreamWriter sw = new StreamWriter(codeFile))

{

    sw.Write(codeString);

}

如今文件是有了，该把它加到项目里了，很简单：

Document.ProjectItem.ProjectItems.AddFromFile(codeFile);

说到这个方法，要顺便说一句。都知道当咱们添加了一个.aspx文件后，会自动产生一个.aspx.cs的文件，而且这个文件会存在于.aspx文件下，这是个很酷的特性，以前在搜索如何实现的时候，网上给出了大体有3种方法，如修改preject file的内容，添加dependupon元素，或者修改注册表等方法，其实不用那么麻烦，经过上面的方法，.cs文件自动被添加到.msgatde文件下面了，效果以下：

最后讲下部署插件，在插件的项目里，有个{prjoectname}.AddIn文件，将其copy到\Documents\Visual Studio 2010\Addins目录下，而后将其用文本编辑软件打开：

其中第十行是说明该插件的dll文件所在的路径，将其修改成正确的路径。固然，你也能够将文件也复制到该目录下。

 

ok，目前关于如何建立一个代码生成插件的部分就讲完了。这里只是记录了我在学习如何建立这个插件过程当中遇到的难点，不少细节部分并无写下来，还有不少东西须要完善，好比每次生成代码，能够把生成的结果输出到output window，若是出错了，也把错误的缘由output出来。

private void OutputToOPW(string format, params object[] objs) 
{ 
    OutputWindow ow = this.applicationObject.ToolWindows.OutputWindow; // applicationObject 是 一个DTE2对象 
    OutputWindowPane owp = null; 
    try 
    { 
        owp = ow.OutputWindowPanes.Item("MyAddin"); 
    } 
    catch 
    { 
        owp = ow.OutputWindowPanes.Add("MyAddin"); 
    } 
    owp.Activate(); 
    owp.OutputString(string.Format(format, objs)); 
}

最后，推荐一本书：《Practical.Code.Generation.in.NET》。多亏了这本书，才解决了我以前的不少困扰。

原文：http://www.cnblogs.com/FMax/archive/2011/07/09/2101699.html