下载DCG提供试用版的方法

看来越来越多的人对DCG感兴趣了，这我很高兴，不过大家不必太着急，我也是在边做边给大家一个预览，这总比等待所有都做好后在告诉大家要好的多，大家可以知道第一手消息。;-)

不过我也不愿意拖的太久，所以周五下班后就请朋友将做好的DCG上传了，同时还上传了在上一次提到的读取XML文件的示例。下载地址分别为

http://www.swallow.net.cn/dcg/dcg.zip
http://www.swallow.net.cn/dcg/ConstructClassForXml.zip

在这里对朋友Laser的感谢，多谢为我提供空间^_^ 为了让读者在下载后能够马上运用起DCG，我觉得有必要在这里稍微描述一下动态模板的语法，其实很简单，规则如下：

1. <%@ header params="value" %>，这种形式的tag是模板的headers，模板所支持的所有headers如下：

   1. <%@ Template Language="language" [Name="templateName"] [Version="templateVersion"]%>，模板必须有这么一个header，有了这个header，一个模板才算是正确的模板，它的Language属性指定了模板中动态代码使用的是什么语言。此header只能出现一次。

   2. <%@ Assembly Location="assemblyLocation" %>，这个header指出模板要引用哪个程序集，注意被引用的程序集必须在模板的根目录下，并且在指定引用时不能有任何路径信息，如：<% Assembly Location="MyAssembly.dll" %>。这个tag可以多次出现。

   3. <%@ Import Namespace="namespace" [As="alias"] %>，就像C#中的using namespace一样，这个header导入模板中的动态代码要用到的命名空间。可以多次出现。

   4. <%@ Parameter Name="paramName" DataType="paramDataType" %>，这是个比较关键的header，它指定模板为了运作需要哪些参数，这些参数又分别是什么类型的。可以多次出现。

2. <%code block %>，在这种tag中的代码为动态代码，这种动态代码并不返回任何值。

3. <%= code block%>，在这种tag中的代码为动态代码，这种动态代码要求返回值。

4. <%# function block%>，这种tag定义了一个模板方法，这种模板方法可以在模板的任何其他地方调用。

5. <%-- comment block --%>，位于这种tag之内的所有文字都被视为注释，在解析时将会被忽略掉。

6. DCG内置类，这个内置类可在任何地方调用，目前它含有两个成员，如下：

   1. FileInfo，一个System.IO.FileInfo类型的属性，含有关于模板物理文件的信息，如CreationTime等。

   2. CallTemplate方法，这个方法有两个参数，C#中签名如下，string CallTemplate(string templatePath, object[] paramValues)，第一个参数要求被调用的模板路径，第二个参数要求被调用模板所需要的参数对象。另外关于这个嵌套模板的使用，读者要注意避免循环调用现象，否则会出现死循环。

好了，这就是基本的模板语法了，比较简单，尤其是用过CodeSmith或ASP的人就更容易上手了。至于OCD的语法嘛，实际上90%与模板的语法一样，只是稍有不同，不同之处如下：

1. header中的Template被改为OCD以明确他们之间的不同。

2. header中Parameter被改为Object以表达在模板中是接受一个参数，而在OCD中是制造一个对象的区别。

3. 模板中的动态代码是放在<% %>中，而OCD却不用，因为OCD中的代码全部都是动态的，但OCD中的方法还是用模板同样的语法，即<%# %>。

好了，除了这些不同外，它们完全一样。懂得了模板与OCD的语法后，你就能下载DCG v1.3.4.0并马上开始使用了。DCG文件包包括以下文件：

1. DCG.dll，DCG本身。
2. Clean.exe，需与DCG放在一起使用，用来清理临时文件，如果不和DCG在同一个目录下，那么运行所产生的临时文件就是个问题了，所以必须重视哦。
3. dcgconsole.exe，以前所提到的Console Application，使用方法请见dcgconsole本身（在提示行下输入dcgconsole不加参数）。

如果你想将直接引用DCG.dll在你的项目中使用的话，那么调用模板的C#示例方法如下：

// 获得模板管理器。
ITemplateManager templateManager = TemplateManager.Instance;
// 通过模板管理器获得模板。
ITemplate myFirstTemplate = templateManager.GetTemplate(ReadTemplateContent(templateLocation), templateLocation);

// 准备模板所需要的参数对象。
string templateNameParam = "123";
// 调用模板返回结果。
string result = myFirstTemplate.GenerateCode(new object[] {templateNameParam});

正如你所见，在你的代码中调用模板其实很简单，不过注意这里我没有加任何try catch代码，实际运用中模板经常会因为各种原因出错，比如模板定义不对，模板中的动态代码有编译错误、模板中的动态代码有运行错误等等，所以DCG中还给出了一系列的异常类型来提供对异常的分类与处理，关于这个读者可以看看DCG.dll的每个类型，我想看一下就足够理解它们的了，至于详细文档，我会慢慢给出的，毕竟我的时间也不是很多。

最后我希望读者帮忙给出意见，无论是你觉得DCG好还是坏，都希望读者能对DCG给出反馈，以便我对它的加强，谢谢，并祝您编码愉快！