System.ConfigurationManager类用于对配置文件的读取。其具有的成员如下：
一、AppSettings
AppSetting是最简单的配置节，读写非常简单。
| 名称 | 说明 |
| AppSettings | 获取当前应用程序默认配置的 AppSettingsSection 数据 |
| ConnectionStrings | 获取当前应用程序默认配置的 ConnectionStringsSection 数据 |
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<appSettings>
<add key="DB" value="Access" />
</appSettings>
<connectionStrings>
<add name="connstr" connectionString="Provider=Microsoft.Jet.OLEDB.4.0;Data Source=F:C#CodeDBOperationykjj.mdb"/>
</connectionStrings>
</configuration>
示例：
class Program
{
static void Main(string[] args)
{
string strAppSettings = System.Configuration.ConfigurationManager.AppSettings["DB"]; //通过属性索引获取值
Console.WriteLine(strAppSettings);
string strConnection = System.Configuration.ConfigurationManager.ConnectionStrings["connstr"].ToString();
Console.WriteLine(strConnection);
Console.ReadKey();
}
}
对于以上这一个appSettings与connectionStrings都是由ConfigurationManager提供的两个属性来读取的。通常大多数的配置信息都可以放在appSettings里。但是如果你觉得不够用了，你还可以使用自定义配置信息。
二、自定义配置节
1、自带Handler
关于自定义配置节，Configuration提供了很多Handler类来供你选择使用。甚至如果你觉得不够，还可以自定义处理Handler。
先来学下使用怎么使用三个简单的Handler：
- System.Configuration.NameValueSectionHandler
- System.Configuration.DictionarySectionHandler
- System.Configuration.SingleTagSectionHandler
配置文件代码示例：
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="Person" type="System.Configuration.NameValueSectionHandler"/> <!--以NameValue键值/对的形式返回配置节中的信息-->
<section name="Man" type="System.Configuration.DictionarySectionHandler"/> <!--以Dictionary字典键值对的形式返回配置节中的信息-->
<section name="Name" type="System.Configuration.SingleTagSectionHandler" /> <!--基础结构。处理 .config 文件中由单个 XML 标记所表示的各配置节。-->
</configSections>
<Person>
<add key="老大" value="刘备" />
<add key="老二" value="关羽" />
<add key="老三" value="张飞" />
</Person>
<Man>
<add key="老大" value="曹操" />
<add key="老二" value="典韦" />
<add key="老三" value="郭嘉" />
</Man>
<Name one="1" two="2" three="3" four="4" five="5" /> <!--注意是要单个节SingleTagSectionHandler才能处理，但是无论你索性有多少个也能处理-->
</configuration>
读取代码示例：
static void Main(string[] args)
{
//读取人名
NameValueCollection nvc = (NameValueCollection)ConfigurationManager.GetSection("Person");
foreach (string key in nvc.AllKeys)
{
Console.WriteLine(key + ":" + nvc[key]);
}
//读取男人
IDictionary dict = (IDictionary)ConfigurationManager.GetSection("Man");
foreach (string key in dict.Keys)
{
Console.WriteLine(key + ":" + dict[key]);
}
IDictionary dict1 = (IDictionary)ConfigurationManager.GetSection("Name");
foreach (string key in dict1.Keys)
{
Console.WriteLine(key + ":" + dict1[key]);
}
Console.ReadKey();
}
输出结果如下：
2、自定义Handler
自定义读取节点需要实现接口IConfigurationSectionHandler，并提供Create的具体实现。
Appconfig代码：
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections> <!--后面的type是处理处理节点PersonHandler所在的位置第二个参数是程序集，你可以不要Version开始之后的-->
<section name="Person" type="ConsoleApplication1.PersonHandler,ConsoleApplication1,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null" allowLocation="true" allowDefinition="Everywhere" />
</configSections>
<Person age="23" name="刘备" />
</configuration>
主程序代码：
按 Ctrl+C 复制代码
按 Ctrl+C 复制代码
输出结果如下：
这样的配置代码看起来还是有点吃力，毕竟Hashtable的层次有两层。
3、property属性的方式读取
- 使用这种方法，需要自定义一个类，并且要继承自ConfigurationSection基类。ConfigurationProperty的构造函数中传入的name字符串将会用于config文件中，表示各参数的属性名称。
- 属性的值的读写要调用this[]或base[]，由基类去保存，请不要自行设计Field来保存。
- 为了能使用配置节点能被解析，需要在<configSections>中注册： <section name="Person" type="ConsoleApplication1.PersonSection,ConsoleApplication1,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null" allowLocation="true" allowDefinition="Everywhere" /> ，且要注意name="Person"要与<Person ..... >是对应的。
先来看看配置文件的写法：
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections> <!--后面的type是处理处理节点PersonSection所在的位置第二个参数是程序集，你可以不要Version开始之后的-->
<section name="Person" type="ConsoleApplication1.PersonSection,ConsoleApplication1,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null" allowLocation="true" allowDefinition="Everywhere" />
</configSections>
<Person age="23" name="刘备" />
</configuration>
然后程序代码：
class Program
{
static void Main(string[] args)
{
PersonSection person = ConfigurationManager.GetSection("Person") as PersonSection;
Console.WriteLine("name={0},age={1}", person.Age, person.Name);
Console.ReadKey();
}
}
//注意 这里是继承自System.Configuration.ConfigurationSection了
class PersonSection : System.Configuration.ConfigurationSection
{
[ConfigurationProperty("age", IsRequired = false, DefaultValue = 0)]
public int Age
{
get { return (int)base["age"]; }
set { base["age"] = value; }
}
[ConfigurationProperty("name", IsRequired = false, DefaultValue = "")]
public string Name
{
get { return (string)base["name"]; }
set { base["name"] = value; }
}
}
输出结果如下：
4、配置子元素
对于稍微在复杂一点的结构，子元素的Model类要继承自ConfigurationElement。
config文件代码：
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="complex" type="ConsoleApplication1.ComplexSection,ConsoleApplication1"/>
</configSections>
<complex height="182">
<child firstName="张" lastName="飞"/>
</complex>
</configuration>
主程序代码：
class Program
{
static void Main(string[] args)
{
ComplexSection sec = ConfigurationManager.GetSection("complex") as ComplexSection;
Console.WriteLine(sec.Height); //访问属性
Console.WriteLine(sec.Child.FirstName); //访问子节点属性
Console.WriteLine(sec.Child.LastName); //访问子节点属性
Console.ReadKey();
}
}
public class ComplexSection : ConfigurationSection
{
[ConfigurationProperty("height", IsRequired = true)]
public int Height
{
get { return (int)base["height"]; }
set { base["height"] = value; }
}
[ConfigurationProperty("child", IsDefaultCollection = false)]
public ChildSection Child
{
get { return (ChildSection)base["child"]; }
set { base["child"] = value; }
}
}
public class ChildSection : ConfigurationElement
{
[ConfigurationProperty("firstName", IsRequired = true, IsKey = true)]
public string FirstName
{
get { return (string)base["firstName"]; }
set { base["firstName"] = value; }
}
[ConfigurationProperty("lastName", IsRequired = true)]
public string LastName
{
get { return (string)base["lastName"]; }
set { base["lastName"] = value; }
}
}
输出结果如图所示:
5、配置文件中的CDATA
有时候，在配置文件里可能会包含一些比较复杂的代码段，这时候就要用到XML的CDATA了。
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="MySection" type="ConsoleApplication1.MySection, ConsoleApplication1" />
</configSections>
<MySection>
<HTML>
<![CDATA[
<div style="# font-size:24px">加粗显示</div>
]]>
</HTML>
<SQL>
<![CDATA[
SELECT TOP 10 * FROM Person
]]>
</SQL>
</MySection>
</configuration>
主程序代码如下：
namespace ConsoleApplication1
{
class Program
{
static void Main(string[] args)
{
MySection section = ConfigurationManager.GetSection("MySection") as MySection;
Console.WriteLine("{0}{1}", section.HTML.CommandText, section.SQL.CommandText);
Console.ReadKey();
}
}
//注意 这里是继承自System.Configuration.ConfigurationSection了
class MySection : System.Configuration.ConfigurationSection
{
[ConfigurationProperty("HTML", IsRequired = false)]
public MyTextElement HTML
{
get { return (MyTextElement)base["HTML"]; }
set { base["HTML"] = value; }
}
[ConfigurationProperty("SQL", IsRequired = false)]
public MyTextElement SQL
{
get { return (MyTextElement)base["SQL"]; }
set { base["SQL"] = value; }
}
}
public class MyTextElement : ConfigurationElement
{
protected override void DeserializeElement(System.Xml.XmlReader reader, bool serializeCollectionKey)
{
CommandText = reader.ReadElementContentAs(typeof(string), null) as string;
}
protected override bool SerializeElement(System.Xml.XmlWriter writer, bool serializeCollectionKey)
{
if (writer != null)
{
writer.WriteCData(CommandText);
}
return true;
}
[ConfigurationProperty("data", IsRequired = false)]
public string CommandText
{
get { return this["data"].ToString(); }
set { this["data"] = value; }
}
}
}
输出如下：
6、配置元素Collection
类似下面的配置方式，在ASP.NET的HttpHandler, HttpModule中太常见了。
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="MySection" type="ConsoleApplication1.MySection, ConsoleApplication1" />
</configSections>
<MySection>
<add key="a" value="刘备"></add>
<add key="b" value="关羽"></add>
<add key="c" value="张飞"></add>
</MySection>
</configuration>
实现代码如下：
class Program
{
static void Main(string[] args)
{
MySection section = ConfigurationManager.GetSection("MySection") as MySection;
foreach (MyKeyValueSetting add in section.KeyValues)
{
Console.WriteLine(add.Key + ":" + add.Value);
}
Console.ReadKey();
}
}
public class MySection : ConfigurationSection // 所有配置节点都要选择这个基类
{
private static readonly ConfigurationProperty s_property = new ConfigurationProperty(string.Empty, typeof(MyKeyValueCollection), null, ConfigurationPropertyOptions.IsDefaultCollection);
[ConfigurationProperty("", Options = ConfigurationPropertyOptions.IsDefaultCollection)]
public MyKeyValueCollection KeyValues
{
get
{
return (MyKeyValueCollection)base[s_property];
}
}
}
[ConfigurationCollection(typeof(MyKeyValueSetting))]
public class MyKeyValueCollection : ConfigurationElementCollection // 自定义一个集合
{
// 基本上，所有的方法都只要简单地调用基类的实现就可以了。
public MyKeyValueCollection() : base(StringComparer.OrdinalIgnoreCase) // 忽略大小写
{
}
// 其实关键就是这个索引器。但它也是调用基类的实现，只是做下类型转就行了。
new public MyKeyValueSetting this[string name]
{
get { return (MyKeyValueSetting)base.BaseGet(name); }
}
// 下面二个方法中抽象类中必须要实现的。
protected override ConfigurationElement CreateNewElement()
{
return new MyKeyValueSetting();
}
protected override object GetElementKey(ConfigurationElement element)
{
return ((MyKeyValueSetting)element).Key;
}
// 说明：如果不需要在代码中修改集合，可以不实现Add, Clear, Remove
public void Add(MyKeyValueSetting setting)
{
this.BaseAdd(setting);
}
public void Clear()
{
base.BaseClear();
}
public void Remove(string name)
{
base.BaseRemove(name);
}
}
public class MyKeyValueSetting : 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; }
}
}
输出如下：
小结：
1. 为每个集合中的参数项创建一个从ConfigurationElement继承的派生类。
2. 为集合创建一个从ConfigurationElementCollection继承的集合类，具体在实现时主要就是调用基类的方法。
3. 在创建ConfigurationSection的继承类时，创建一个表示集合的属性就可以了，注意[ConfigurationProperty]的各参数。
7、配置节点的写入
写入配置节点的示例如下：
Configuration config = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None);
PersonSection Section = config.GetSection("Person") as PersonSection;
Section.Name = "撼地神牛";
Section.Age = 10000;
config.Save();
ConfigurationManager.RefreshSection("Person"); //让修改之后的结果生效
在修改配置节点前，我们需要调用ConfigurationManager.OpenExeConfiguration()，然后调用config.GetSection()在得到节点后，转成我们定义的节点类型， 然后就可以按照强类型的方式来修改我们定义的各参数项，最后调用config.Save();即可。
注意：
- .net为了优化配置节点的读取操作，会将数据缓存起来，如果希望使用修改后的结果生效，您还需要调用ConfigurationManager.RefreshSection(".....")。
- 如果是修改web.config，则需要使用 WebConfigurationManager。
8、读取.Net Framework中已经定义的节点
.Net Framework已定义节点的读取很简单：
<system.web>
<httpModules>
<add name="ScriptModule" type="System.Web.Handlers.ScriptModule, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>
<add name="UrlRoutingModule" type="System.Web.Routing.UrlRoutingModule, System.Web.Routing, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>
</httpModules>
</system.web>
主程序如下：
public ActionResult Index()
{
HttpModulesSection section = ConfigurationManager.GetSection("system.web/httpModules") as HttpModulesSection;
foreach (HttpModuleAction action in section.Modules)
{
Response.Write(action.Name + "<br/>");
}
return Content("");
}
输出如下：
