首页 > 代码库 > 配置文件的读写

配置文件的读写

 System.ConfigurationManager类用于对配置文件的读取。其具有的成员如下:

一、AppSettings

   AppSetting是最简单的配置节,读写非常简单。

名称说明
AppSettings获取当前应用程序默认配置的 AppSettingsSection 数据
ConnectionStrings获取当前应用程序默认配置的 ConnectionStringsSection 数据

 

<?xml version="1.0" encoding="utf-8" ?><configuration>  <appSettings>    <add key="DB" value="http://www.mamicode.com/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="http://www.mamicode.com/刘备" />    <add key="老二" value="http://www.mamicode.com/关羽" />    <add key="老三" value="http://www.mamicode.com/张飞" />  </Person>  <Man>    <add key="老大" value="http://www.mamicode.com/曹操" />    <add key="老二" value="http://www.mamicode.com/典韦" />    <add key="老三" value="http://www.mamicode.com/郭嘉" />  </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 = http://www.mamicode.com/0)]"age"]; }             set { base["age"] = value; }        }        [ConfigurationProperty("name", IsRequired = false, DefaultValuehttp://www.mamicode.com/= "")]        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="http://www.mamicode.com/刘备"></add>    <add key="b" value="http://www.mamicode.com/关羽"></add>    <add key="c" value="http://www.mamicode.com/张飞"></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程序的写与上面的例子一样,此处不再复述。