Bear-Study-Hard

In 2008, I am absorbed in MOSS 2007, WF, ASP.NET 2.0, WPF, WCF and Wirte more Articles. ^_^
posts - 161, comments - 659, trackbacks - 118, articles - 0
  博客园 :: 首页 :: 新随笔 :: 联系 :: 订阅 订阅 :: 管理

CodeSmith基础（八）

Posted on 2005-12-26 12:22 努力学习的小熊 阅读(3708) 评论(7)  编辑 收藏 所属分类: CodeSmith使用

        编写CodeSmith自定义属性的编辑器（Writing Custom Property Editors）

        当你开始编写自定义的CodeSmith模板时，很可能对于使用它的strings或integers属性很满意，但有时你会发现需要创建一个不同类型的属性，可能是一个自定义的类型或者是.NET framework中但是在属性面板中没有提供的类型。在模板中去作这些很简单，但是怎样指定一个类型在运行模板时显示在属性面板中呢？例如创建了一个Person类并且具有很多不同的属性，但是却没有办法让用户去组装这个类……除非创建一个自定义属性编辑器。

        属性面板提供了方法去编写自定义的属性编辑器，当用户在面板上选择一个属性时可以激发相应的方法，同时也可以通过编写代码实现提示用户输入一个必要的值。下面我们举个例子，创建一个接受组建的属性并且是用影射循环贯串所有的类，是所有的类都可以使用它和它的方法，去创建一个NUnit测试基础。（这句翻译的不好，原文：As an example we are going to build a template which accepts an assembly as a property and then using reflection loops through all of the classes, and the methods of those classes, to build NUnit test stubs.）

        首先，我们来关注一下模板的组件属性，暂且不看自定义编写的代码。模板的第一部分是一些声明定义和属性。将属性放在脚本标签中代替使用属性声明，在下一部分将看到这样做的必要。

 1<%@ CodeTemplate Language="C#" TargetLanguage="C#" Description="Builds a class for each class in the assembly, and a test stub for every method." %>
 2
 3<%@ Import NameSpace="System.Reflection" %>
 4
 5<script runat="template">
 6
 7private Assembly assembly;
 8
 9public Assembly AssemblyToLoad
10{
11      get{return assembly;}
12      set{assembly = value;}
13}
14
15</script>

        然后我们为组建assembly中的每一个类创建一个类，为每一个类创建他的方法。然后直接将模板的输出内容放入Visual Studio.NET，然后在编写组件的单元测试时使用向导。

 1using System;
 2using NUnit.Framework;
 3
 4<%
 5      foreach(Type T in AssemblyToLoad.GetTypes())
 6      {
 7            if(T.IsClass)
 8            {
 9                  %>
10
11                  [TestFixture]
12                  public class <%=T.Name%>Tests
13                  {
14                  <%
15                              MethodInfo[] methods = T.GetMethods ( BindingFlags.Public | BindingFlags.Instance | BindingFlags.Static  );
16                              foreach(MethodInfo M in methods)
17                              {
18                                    %>
19
20                                    [Test]
21                                    public void <%=M.Name%>Test
22                                    {
23                                          //TODO Write this test
24                                    }                 
25                                    <%
26                              }
27
28                  %>}<%
29            }
30      }
31%>

        这个模板仅仅可以编译通过，但是由于我们编写显示了一个类型属性面板并不知道如何去操作它，所以我们没有办法自定义指定组件在加载时想要加载的组件。

        我们需要创建一个UITypeEditor，这是一个建立属性面板是用的特殊属性的类。UITypeEditor需要创建在一个和模板分离的组件中，我们是用Visual Studio创建这个类。

 /Files/Bear-Study-Hard/AssemblyHelper.zip

        首先我们需要创建一个继承UITypeEditor的类。

1public class AssemblyFilePicker : UITypeEditor
2{
3      public AssemblyFilePicker(): base()
4      {
5      }
6}

        关于UITypeEditor的说明请大家参看MSDN或Visual Studio.NET自带帮助中的说明，其中有详细的例子。

        然后我们需要重载UITypeEditor类的两个不同的方法。第一个需要重载点的方法是GetEditStyle，这个方法是告诉属性面板对于当前类型是用什么类型的编辑器，在这个例子中我们设置编辑类型为Modal。这样大家可以在该属性格子的右边看到一个小按钮，它将引发一个对话框等模式的对话（trigger a modal dialog）。这是我们的GetEditStyle方法：

1public override UITypeEditorEditStyle GetEditStyle(ITypeDescriptorContext context) 
2{
3      return UITypeEditorEditStyle.Modal;
4}

        其中的Modal为显示一个省略号按钮。

        需要重载的另一个方法是EditValue方法，当用户电击属性时会调用这个方法。按照我们需要加载的组件类型需要创建一个打开文件对话框（open file dialog）然后捕获这个对话框，在属性格子中返回对话框的结果。

1public override object EditValue(ITypeDescriptorContext context, IServiceProvider provider, object value)
2{
3
4if (provider != null) 
5{

        首先我们要从当前的服务和控件中得到一个参考，有了控件的参考我们可以通过它转到ShowDialog方法。（原文：First we need to get a reference to the current service and control, we need the reference to the control so we can pass it to the ShowDialog method.）

1IWindowsFormsEditorService editorService = (IWindowsFormsEditorService)provider.GetService(typeof(IWindowsFormsEditorService));
2Control editorControl = editorService as Control;
3
4if (editorControl != null) 
5{

        然后我们创建一个openFileDialog类并填入适合的属性。

1OpenFileDialog openFileDialog = new OpenFileDialog();                         
2
3openFileDialog.CheckFileExists = true;
4openFileDialog.DefaultExt = ".dll";
5openFileDialog.Multiselect = false;
6openFileDialog.Title = "Select an Assembly:";
7openFileDialog.Filter = "Assembly Files | *.dll";

        然后我们通过控件的参考（reference）将对话框显示给用户。

1DialogResult result = openFileDialog.ShowDialog(editorControl);

        下一步我们检查用户是否点击了OK按钮，如果点击了，通过文件选择对话框选择文件后使用LoadForm方法加载这个组件，最后返回这个值。

 1if (result == DialogResult.OK)
 2            {
 3Assembly assembly = Assembly.LoadFrom( openFileDialog.FileName ) ;
 4                  value = assembly; 
 5            }
 6            else
 7            {
 8                  value = null;
 9            }
10      }
11}
12
13return value;
14}

        这个值将被放在属性面板中并可以被模板读取，但是需要注意，在我们作这个之前要将组件import引入到模板中，并在模板中用一对属性声明。

        加载这个模板我们仅需将这个组件assembly与模板放在同一目录下，然后再模板中加入下面两行代码。

1<%@ Assembly Name="AssemblyHelper" %>
2<%@ Import NameSpace="AssemblyHelper" %>

        然后我们要在组建属性中添加Editor属性，并且指定为UITypeEditor编辑器。

1[Editor(typeof(AssemblyHelper.AssemblyFilePicker), typeof(System.Drawing.Design.UITypeEditor))]
2public Assembly AssemblyToLoad
3{
4      get{return assembly;}
5      set{assembly = value;}
6}

        当属性面板读取到这些属性时，它将使用我们自定义的UITypeEditor编辑器并允许用户从打开文件对话框中选择一个组件。

Feedback

#1楼    回复  引用    

2007-06-13 09:14 by kaishui [未注册用户]
辛苦了,As an example we are going to build a template which accepts an assembly as a property and then using reflection loops through all of the classes, and the methods of those classes,
按我理解是:
我们将创建一个具有"程序集"属性的模板(就是说这个模板有一个参数,该参数是一个"程序集"类型[.net的一个DLL]),使用反射技术可以得到该程序集中的所有类和类的方法.

#2楼 [楼主]   回复  引用  查看    

2007-06-13 09:19 by 努力学习的熊      
@kaishui
这个解释还真差不多，呵呵，多谢：）

#3楼    回复  引用    

2007-09-18 13:48 by 韩子虔 [未注册用户]
就凭熊哥这个辛苦劲，
也得先顶后看！

#4楼    回复  引用    

2008-06-30 17:33 by 飘飘 [未注册用户]
up 看完了

#5楼    回复  引用    

2008-07-19 07:50 by songsongkk [未注册用户]
熊哥，把错别字改掉好不好

#6楼    回复  引用  查看    

2008-08-14 15:39 by 末名      
我看了你几篇文章受益非浅！
在这一章里你讲的我有些不明白。我试了一下，编辑通不过的。
我把/Files/Bear-Study-Hard/AssemblyHelper.zip下载之后，
新建一个模版文件trytemp.cst
代码如下？
<%@ CodeTemplate Language="C#" TargetLanguage="C#" Description="Builds a class for each class in the assembly, and a test stub for every method." %>
<%@ Import NameSpace="System.Reflection" %>
<%@ Assembly Name="AssemblyHelper" %>
<%@ Import NameSpace="AssemblyHelper" %>

<script runat="template">

private Assembly assembly;
[Editor(typeof(AssemblyHelper.AssemblyFilePicker), typeof(System.Drawing.Design.UITypeEditor))]
public Assembly AssemblyToLoad
{
get{return assembly;}
set{assembly = value;}
}

</script>

“加载这个模板我们仅需将这个组件assembly与模板放在同一目录下”是说刚下载的那个文件和trytemp.cst放在同一目录吗？我还把assembly项目里的AssemblyHelper.dll文件copy出来。也放在了trytemp.cst的同一目录。


编辑却是通不过的


---------------- Compile started -----------------

D:\work\projects\try\assemblyhelper\AssemblyHelper\trytemp.cst(3,0): error CODESMITH0001: Unable to resolve assembly "AssemblyHelper".

Build complete -- 1 errors, 0 warnings

---------------------- Done ----------------------

Build failed

模版文件里<%@ Assembly Name="AssemblyHelper" %>
这一行打了曲线，是不是找不到AssemblyHelper程序集呢？
我还把这个AssemblyHelper.dll放到的codesmith的安装目录的dll里
D:\Program Files\CodeSmith\v4.0\bin
还是会出现上面的问题。


我的codesmith安装在D:\Program Files\CodeSmith\v4.0\bin
trytemp.cst在目录在D:\work\projects\try
请熊哥为我解疑，我当不胜感激。


标题  
姓名  
主页
Email (只有博主才能看到) 
验证码 *  看不清,换一张 [登录][注册]
内容(请不要发表任何与政治相关的内容)  
  登录  使用高级评论  新用户注册  返回页首  恢复上次提交      


相关链接:

最新IT新闻:
惠普139亿美元完成对EDS的收购
搜狗五笔输入法发布
新学年开始 大学生适用的十大互联网应用
Google拟在9月发布自有浏览器 或采用火狐内核
微软正在构思将Wi-Fi带入汽车
博客园新闻频道  博客园首页  社区