收藏一款好用的基于.NET的配置文件设计工具

在进行框架开发的过程中，我们往往需要对配置文件的结构进行设计，以便产生一套完整的配置方案，供开发人员在使用框架时能对框架进行配置。对于某些大型的框架，其配置节点的结构可能相当复杂，比如某个配置节点（Configuration Element）可以有属性，还可以在其下挂载多个其它的配置节点或者多个配置节点集合（Configuration Element Collection）。如果使用手动编写代码的方式来维护与配置相关的代码，势必会出现大量的重复劳动，比如，需要给每个配置属性添加System.Configuration.ConfigurationPropertyAttribute特性，需要为各个配置节点集合采用相同的代码编写模式（例如重写其中的CreateElement等方法）。这样做不仅耗时而且容易出错。更进一步，Visual
Studio支持智能感知技术，如果我们在配置文件编辑器上设置了所要用到的配置信息XSD Schema文件，我们就可以利用智能感知方便快速地编写配置文件。然而，如果我们的配置节点采用手工代码维护，那么在编写完代码之后，还需要另外编写一套XSD Schema文件，以使得开发人员在使用我们的框架时，能够享受到智能感知带来的便捷，这样做不仅工作量大，而且一旦配置信息结构变得复杂，我们就很难确保代码与XSD Schema之间的对应关系。

今天我向大家介绍一款个人觉得比较不错的基于.NET的配置文件设计工具：Configuration Section Designer。它是一款使用Microsoft Visualization & Modeling SDK开发的面向配置文件设计领域的领域特定语言（DSL，有关DSL的知识，我会在后续的博客文章中向大家介绍）。如果你使用的是Visual Studio
2005/2008，你可以去Configuration Section Designer的主页下载安装包。如果你使用的是Visual Studio 2010，那么你还可以使用VS2010的Extension Manager来找到这个设计工具。

下载与安装

可以到Configuration Section Designer的下载页面下载并安装该工具。如果你使用的是Visual Studio 2005/2008，你将得到一个EXE的安装程序；如果你使用的是Visual Studio 2010，你将得到一个VSIX的扩展包。我使用的是Visual Studio 2010，因此接下来都会以Visual Studio
2010进行介绍。

在得到VSIX扩展包后，双击直接打开运行就可以将其安装到Visual Studio 2010的开发环境中。

新建配置文件项目

首先你可以使用Visual Studio 2010随便创建一个项目（比如Class Library或者Console Application都可以），然后在这个项目上单击鼠标右键，选择Add –> New Item菜单，这将打开Add New Item对话框，在Installed Templates –> Visual C# Items节点下，找到ConfigurationSectionDesigner，更改名称后单击Add按钮。





在完成Designer Surface的创建之后，我们可以看到在项目中多了一个.csd的文件，在Toolbox中，也出现了与配置文件设计相关的工具：





看上去是不是有点像ADO.NET Entity Framework的设计器？不错，这就是Microsoft Visualization & Modeling SDK给我们带来的强大功能：它允许开发人员设计自己的领域特定语言（Domain Specific Language, DSL），并以VSIX等扩展包的方式集成到Visual Studio开发环境中。

功能介绍

本文不打算讲解如何使用Configuration Section Designer来设计配置文件，只对其中的一些非常不错的功能进行介绍。

自动化代码与文件的生成

对于一款DSL来说，自动化代码生成不算是什么强大的功能，但是这款工具不仅仅会产生代码，而且还会产生与之相关的XSD Schema以及配置文件样本（Sample Configuration File），能让开发者直观地看到最终效果：

配置文件样本测试

在设计配置文件的过程中，你可以直接双击产生的.csd.config（比如上面的ConfigurationSectionDesigner1.csd.config）文件，然后在里面进行编辑，来测试你的设计是否正确。注意这个编辑过程是自带有智能感知的：

Windows Forms设计器的支持

一个专业的开发框架在向用户提供配置相关的代码以及XSD Schema的同时，还应该为用户提供方便的配置文件编辑器（例如Microsoft Patterns & Practices Enterprise Library通常都会带有面向各种Application Block的配置编辑器）。试想我们将用Windows Forms及其Property Grid控件来设计一款配置文件编辑器，在将配置对象绑定到Property Grid时，Property Grid会通过反射将该对象下所有的属性都显示出来。然而对于配置编辑器而言，我们不仅需要控制配置对象中各个属性的显示方式，而且还需要对这些属性进行一些描述和归类。如果是手工维护框架中的配置代码，这个问题好解决：直接向每个属性手工添加诸如System.ComponentModel.DescriptionAttribute、System.ComponentModel.BrowsableAttribute等特性即可。但如果整个配置代码都是由某工具自动化生成的，那么你就不能直接在生成的代码上就行手工修改，而只能通过System.ComponentModel.DataAnnotations.AssociatedMetadataTypeTypeDescriptionProvider、System.ComponentModel.CustomTypeDescriptor以及System.ComponentModel.PropertyTypeDescriptor类来扩展MetadataType
Description，然后使用System.ComponentModel.DataAnnotations.MetadataTypeAttribute特性以在用于描述源类型的元数据类型上进行特性设置。以下是这种实现方式的相关代码：

public class MyAssociatedMetadataTypeTypeDescriptionProvider : AssociatedMetadataTypeTypeDescriptionProvider
{
publicMyAssociatedMetadataTypeTypeDescriptionProvider(Type type)
:base(type) { }

publicMyAssociatedMetadataTypeTypeDescriptionProvider(Type type, Type associatedMetadataType)

:base(type, associatedMetadataType) { }

privateICustomTypeDescriptor Descriptor { get;set; }

publicoverride ICustomTypeDescriptor GetTypeDescriptor(Type objectType,object instance)
{

if(null == this.Descriptor)

this.Descriptor =new MyCustomTypeDescriptor(base.GetTypeDescriptor(objectType, instance));

returnthis.Descriptor;

}

}

public class MyCustomTypeDescriptor : CustomTypeDescriptor
{

publicMyCustomTypeDescriptor(ICustomTypeDescriptor wrappedTypeDescriptor)
{

this.WrappedTypeDescriptor = wrappedTypeDescriptor;

}

privateICustomTypeDescriptor WrappedTypeDescriptor { get;set; }

publicoverride AttributeCollection GetAttributes()
{

returnthis.WrappedTypeDescriptor.GetAttributes();

}

publicoverride PropertyDescriptorCollection GetProperties()
{

PropertyDescriptorCollection properties =this.WrappedTypeDescriptor.GetProperties();

List<PropertyDescriptor> list =new List<PropertyDescriptor>();

foreach(PropertyDescriptor descriptor inproperties)

list.Add(newMyPropertyDescriptor(descriptor));

returnnew PropertyDescriptorCollection(list.ToArray(),true);

}

publicoverride PropertyDescriptorCollection GetProperties(Attribute[] attributes)
{

returnthis.GetProperties();

}

}

public class MyPropertyDescriptor : PropertyDescriptor
{

publicMyPropertyDescriptor(PropertyDescriptor wrappedPropertyDescriptor)

:base(wrappedPropertyDescriptor)
{

this.WrappedPropertyDescriptor = wrappedPropertyDescriptor;

}

privatePropertyDescriptor WrappedPropertyDescriptor { get; set; }

publicoverride voidAddValueChanged(objectcomponent, EventHandler handler)
{

this.WrappedPropertyDescriptor.AddValueChanged(component, handler);

}

publicoverride boolCanResetValue(objectcomponent)
{

returnthis.WrappedPropertyDescriptor.CanResetValue(component);

}

publicoverride Type ComponentType
{

get
{

returnthis.WrappedPropertyDescriptor.ComponentType;

}

}

publicoverride boolIsReadOnly
{

get
{

returnthis.WrappedPropertyDescriptor.IsReadOnly;

}

}

publicoverride objectGetValue(objectcomponent)
{

returnthis.WrappedPropertyDescriptor.GetValue(component);

}

publicoverride Type PropertyType
{

get

{

returnthis.WrappedPropertyDescriptor.PropertyType;

}

}

publicoverride voidRemoveValueChanged(objectcomponent, EventHandler handler)
{

this.WrappedPropertyDescriptor.RemoveValueChanged(component, handler);

}

publicoverride voidResetValue(objectcomponent)
{

this.WrappedPropertyDescriptor.ResetValue(component);

}

publicoverride voidSetValue(objectcomponent, objectvalue)
{

List<Attribute> attributes =new List<Attribute>();
this.FillAttributes(attributes);
foreach(Attribute attribute inattributes)
{

ValidationAttribute validationAttribute = attributeas ValidationAttribute;

if(null == validationAttribute)

continue;

if(!validationAttribute.IsValid(value))

thrownew ValidationException(validationAttribute.ErrorMessage, validationAttribute, component);

}
this.WrappedPropertyDescriptor.SetValue(component, value);

}

publicoverride boolShouldSerializeValue(objectcomponent)
{

returnthis.WrappedPropertyDescriptor.ShouldSerializeValue(component);

}

publicoverride boolSupportsChangeEvents
{

get
{

returnthis.WrappedPropertyDescriptor.SupportsChangeEvents;

}

}

}

// 以下是使用方式：
[MetadataType(typeof(ApplicationElementMetadata))]
public partial class ApplicationElement
{

staticApplicationElement()
{

TypeDescriptor.AddProvider(

newMyAssociatedMetadataTypeTypeDescriptionProvider(

typeof(ApplicationElement)),typeof(ApplicationElement));

}
}
public class ApplicationElementMetadata
{

[Description("Indicates the provider of the Application.")]

publicstring Provider { get; set; }

}

然而对于Configuration Section Designer而言，这种繁杂的实现方式已经不复存在。它本身就支持Component Model相关特性的设置，然后会在产生的代码中添加相应的特性描述，大大减轻了开发者的负担。





产生的代码如下：





Configuration Section Designer应该还有很多不错的功能，时间关系我也没有进行深入研究，有兴趣的朋友不妨下载一个Configuration Section Designer体验一下。