.net学习笔记---webconfig的读与写

　　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#Code\DBOperation\ykjj.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>

　　主程序代码：

　　class Program

    {

        static void Main(string[] args)

        {

            Hashtable config = ConfigurationManager.GetSection("Person") as Hashtable;

            Console.WriteLine("节点数量是：" + config.Count);

            //2重键值对的方式，其中deKey又可以再次转化为一个Hashtable

            foreach (DictionaryEntry deKey in config)

            {

                Console.WriteLine("属性元素: " + deKey.Key.ToString());

                Hashtable attribs = (Hashtable)deKey.Value;

                foreach (DictionaryEntry deAttrib in attribs)

                {

                    Console.WriteLine(deAttrib.Key.ToString() + "=" + deAttrib.Value.ToString());

                }

            }

            Console.ReadKey();

        }

    }

    //注意必须要实现IConfigurationSectionHandler接口

    class PersonHandler : IConfigurationSectionHandler

    {

        public object Create(object parent, object configContext, System.Xml.XmlNode section)

        {

            Hashtable myConfig = new Hashtable();

            // 本节元素，获取的任何属性。

            Hashtable myAttribs = new Hashtable();

            //遍历当前节点的属性

            foreach (XmlAttribute attrib in section.Attributes)

            {

                //如果当前节点是属性节点，则添加进入myAttribs

                if (XmlNodeType.Attribute == attrib.NodeType)

                {

                    myAttribs.Add(attrib.Name, attrib.Value);

                }

            }

            //把当前属性节点集合添加进myConfig

            myConfig.Add(section.Name, myAttribs);

            return myConfig;

        }

    }

　　输出结果如下：

　　

　　这样的配置代码看起来还是有点吃力，毕竟Hashtable的层次有两层。

　　3、property属性的方式读取

1. 使用这种方法，需要自定义一个类，并且要继承自ConfigurationSection基类。ConfigurationProperty的构造函数中传入的name字符串将会用于config文件中，表示各参数的属性名称。
2. 属性的值的读写要调用this[]或base[]，由基类去保存，请不要自行设计Field来保存。
3. 为了能使用配置节点能被解析，需要在<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();即可。

　　注意：

1. .net为了优化配置节点的读取操作，会将数据缓存起来，如果希望使用修改后的结果生效，您还需要调用ConfigurationManager.RefreshSection(".....")。
2. 如果是修改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("");

    }

　　输出如下：

　　

　　注意，连服务器上mechine里面的配置都会一起读出来。

　　在Web.config里是只读的，写不了，而非Web程序的写与上面的例子一样，此处不再复述。