今天说下C#读写自定义config文件的各种方法。由于这类文章已经很多,但是大多数人举例子都是默认的在app.confg或者web.config进行读写,而不是一般的XML文件,我主要写的是一般的Xml文件,不是默认路径下的app.config.
通常,我们在.NET开发过程中,会接触二种类型的配置文件:config文件,xml文件。今天我主要演示如何创建自己的自定义的配置节点,而不是介绍如何使用appSetting.
首先来看下配置节点。
<?xml version="1.0" ?>
<configuration>
<configSections>
<section name="MySection1" type="ConfigApplicationDemo.MySection1, ConfigApplication" />
<section name="MySection2" type="ConfigApplicationDemo.MySection2, ConfigApplication" />
<section name="MySection3" type="ConfigApplicationDemo.MySection3, ConfigApplication" />
<section name="MySection4" type="ConfigApplicationDemo.MySection4, ConfigApplication" />
</configSections>
<MySection1 name="Halia" url="http://www.cnblogs.com/halia/">
</MySection1>
<MySection2>
<users username="halia" password="test2012"></users> </MySection2>
<MySection3>
<add key="aa" value="11111"></add>
<add key="bb" value="22222"></add>
<add key="cc" value="33333"></add>
</MySection3>
<MySection4>
<add name="aa" id="11111" role="test"></add>
<add name="bb" id="22222" role="key"></add>
<add name="cc" id="33333" role="rest"></add>
</MySection4>
</configuration>
这里大家可以看到我定义了四种不同的section,其中前两种介绍的人很多,这里不多赘述,先看看第三种。
<MySection3>
<add key="aa" value="11111"></add>
<add key="bb" value="22222"></add>
<add key="cc" value="33333"></add>
</MySection3>
这个配置具有一系列数据,这时候就要用到collection,代码如下:
public class MySection3 : ConfigurationSection // 所有配置节点都要选择这个基类
{
private static readonly ConfigurationProperty s_property = new ConfigurationProperty(string.Empty, typeof(TheKeyValueCollection), null,
ConfigurationPropertyOptions.IsDefaultCollection); [ConfigurationProperty("", Options = ConfigurationPropertyOptions.IsDefaultCollection)]
public TheKeyValueCollection KeyValues
{
get
{
return (TheKeyValueCollection)base[s_property];
}
} [ConfigurationCollection(typeof(TheKeyValue))]
public class TheKeyValueCollection: ConfigurationElementCollection // 自定义一个集合
{
new public TheKeyValuethis[string name]
{ get
{
return (TheKeyValue)base.BaseGet(name);
}
}
// 下面二个方法中抽象类中必须要实现的。
protected override ConfigurationElement CreateNewElement()
{
return new TheKeyValue();
}
protected override object GetElementKey
(
ConfigurationElement element)
{
return ((TheKeyValue)element).Key;
}
} public class TheKeyValue : ConfigurationElement // 集合中的每个元素
{
[ConfigurationProperty("key", IsRequired = true)]
public string Key
{
get { return this["key"].ToString(); }
set { this["key"] = value; }
}
[ConfigurationProperty("value", IsRequired = true)]
public string Value
{
get { return this["value"].ToString(); }
set { this["value"] = value; } }
}
}
上面的三个class做了三件事:
1. 为每个集合中的参数项创建一个从ConfigurationElement继承的派生类。
2. 为集合创建一个从ConfigurationElementCollection继承的集合类,具体在实现时主要就是调用基类的方法。
3. 在创建ConfigurationSection的继承类时,创建一个表示集合的属性就可以了,注意[ConfigurationProperty]的各参数。
然后就是读取config中的值,在读取自定节点时,我们需要调用ConfigurationManager.GetSection()得到配置节点,并转换成我们定义的配置节点类,然后就可以按照强类型的方式来访问了。
if (!string.IsNullOrEmpty(ConfigFile))
//这里的ConfigFile是你要读取的Xml文件的路径,如果为空,则使用默认的app.config文件
{ var fileMap = new ExeConfigurationFileMap() { ExeConfigFilename = ConfigFile };
var config = ConfigurationManager.OpenMappedExeConfiguration(fileMap, ConfigurationUserLevel.None);
MySection3 configSection = (MySection3 )config.GetSection("MySection3");
}
else
{
//Get the default config app.config
MySection3 configSection = (MySection3 )ConfigurationManager.GetSection("MySection3");
} var values = from kv in configSection.KeyValues.Cast<TheKeyValue>()
select new
{ key=kv.Key, val=kv.Value)};
我们在来看下section4的配置:
<MySection4>
<add name="aa" id="11111" role="test"></add>
<add name="bb" id="22222" role="key"></add>
<add name="cc" id="33333" role="rest"></add>
</MySection4>
这个关于Collection的写法和第三个差不多,不同之处在于属性的定义是不同的。
public class TheKeyValue : ConfigurationElement // 集合中的每个元素
{
[ConfigurationProperty("name", IsRequired = true)]
public string Name
{
get { return this["name"].ToString(); }
set { this["name"] = value; }
} [ConfigurationProperty("id", IsRequired = true)]
public string Id
{
get { return this["id"].ToString(); }
set { this["id"] = value; } }
} [ConfigurationProperty("role", IsRequired = true)]
public string Role
{
get { return this["role"].ToString(); }
set { this["role"] = value; } }
}
}
然后是获取相应的值:
if (!string.IsNullOrEmpty(ConfigFile))
//这里的ConfigFile是你要读取的Xml文件的路径,如果为空,则使用默认的app.config文件
{ var fileMap = new ExeConfigurationFileMap() { ExeConfigFilename = ConfigFile };
var config = ConfigurationManager.OpenMappedExeConfiguration(fileMap, ConfigurationUserLevel.None);
MySection4 configSection = (MySection4 )config.GetSection("MySection4");
}
else
{
//Get the default config app.config
MySection4 configSection = (MySection4 )ConfigurationManager.GetSection("MySection4");
} var values = from v in configSection.KeyValues.Cast<TheKeyValue>()
select new
{ name=v.Name, id=v.Id,role=v.Role)};
上面就是关于自定义section的一些分享,这里还要说一下section里面的type
<section name="MySection1" type="ConfigApplicationDemo.MySection1, ConfigApplication" />
关于这个type的定义,逗号前面ConfigApplicationDemo.MySection1, 需要对应你的namespace和你的section类的名字,逗号后面需要对应的是你编译出来的dll的名字,很多情况下namespace和dll名字是一样的,但是出现不一样的情况一定要注意,不然type定义不好,或版本不对,会报错,错误如下,程序会告诉你找不到指定的file或者section。
An error occurred creating the configuration section handler for XXX: Could not load type..