首页 > 代码库 > C# App.config 详解
C# App.config 详解
读语句:
String str = ConfigurationManager.AppSettings["DemoKey"];
写语句:
Configuration cfa = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None);
cfa.AppSettings.Settings["DemoKey"].Value = "http://www.mamicode.com/DemoValue";
cfa.Save();
配置文件内容格式:(app.config)
<?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings>
<add key="DemoKey" value="http://www.mamicode.com/*" /> </appSettings> </configuration>
System.Configuration.ConfigurationSettings.AppSettings["Key"]; 但是现在FrameWork2.0已经明确表示此属性已经过时。并建议改为ConfigurationManager或WebConfigurationManager。并且AppSettings属性是只读的,并不支持修改属性值.
但是要想调用ConfigurationManager必须要先在工程里添加system.configuration.dll程序集的引用。(在解决方案管理器中右键点击工程名称,在右键菜单中选择添加引用,.net TablePage下即可找到)添加引用后可以用 String str = ConfigurationManager.AppSettings["Key"]来获取对应的值了。
更新配置文件: Configuration cfa = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None); cfa.AppSettings.Settings.Add("key", "Name") || cfa.AppSettings.Settings["BrowseDir"].Value = "http://www.mamicode.com/name";
最后调用 cfa.Save(); 当前的配置文件更新成功。
读写配置文件app.config 在.Net中提供了配置文件,让我们可以很方面的处理配置信息,这个配置是XML格式的。而且.Net中已经提供了一些访问这个文件的功能。
1.读取配置信息 下面是一个配置文件的具体内容:
<?xml version="1.0" encoding="utf-8"?>
<configuration> <appSettings>
<add key="ConnenctionString" value="http://www.mamicode.com/*" />
<add key="TmpPath" value="http://www.mamicode.com/C:/Temp" />
</appSettings> </configuration>
.net提供了可以直接访问<appsettings>(注意大小写)元素的方法,在这元素中有很多的子元素,这些子元素名称都是“add”,有两个属性分别是“key”和“value”。一般情况下我们可以将自己的配置信息写在这个区域中,通过下面的方式进行访问:
string ConString=System.Configuration.ConfigurationSettings.AppSettings["ConnenctionString"];
在appsettings后面的是子元素的key属性的值,例如appsettings["connenctionstring"],我们就是访问<add key="ConnenctionString" value="http://www.mamicode.com/*" />这个子元素,它的返回值就是“*”,即value属性的值。
2.设置配置信息 如果配置信息是静态的,我们可以手工配置,要注意格式。如果配置信息是动态的,就需要我们写程序来实现。在.Net中没有写配置文件的功能,我们可以使用操作XML文件的方式来操作配置文件。下面就是一个写配置文件的例子。
private void SaveConfig(string ConnenctionString) { XmlDocument doc=new XmlDocument(); //获得配置文件的全路径 string strFileName=AppDomain.CurrentDomain.BaseDirectory.ToString()+"Code.exe.config"; doc.LOAd(strFileName); //找出名称为“add”的所有元素 XmlNodeList nodes=doc.GetElementsByTagName("add"); for(int i=0;i<nodes.Count;i++) { //获得将当前元素的key属性 XmlAttribute att=nodes[i].Attributes["key"]; //根据元素的第一个属性来判断当前的元素是不是目标元素 if (att.Valuehttp://www.mamicode.com/=="ConnectionString") { //对目标元素中的第二个属性赋值 att=nodes[i].Attributes["value"]; att.Value=http://www.mamicode.com/ConnenctionString; break; } } //保存上面的修改 doc.Save(strFileName); }
VS2005中读写配置文件 VS2003中对于应用程序配置文件(app.config或者web.config)只提供了读取的功能。而在VS2005中,对于配置文件的功能有了很大的加强。在VS2005中,对于应用程序配置文件的读写一般使用Configuration,ConfigurationManager两个类。ConfigurationManager类为客户应用程序提供了一个访问的功能。使用ConfigurationManager对象执行打开配置文件的操作后,将会返回一个Configuration的对象。通过程序实现读写配置文件的代码如下所示:
1.创建配置文件中的配置节所对应的类。该类必须继承自ConfigurationSection public sealed class ConfigurationSections : ConfigurationSection { [ConfigurationProperty("filename", DefaultValue = "http://www.mamicode.com/default.txt")] public string FileName { get { return (string)this["filename"]; } set { this["filename"] = value; } } } public sealed class BusinessSpaceConfiguration : ConfigurationSection { [ConfigurationProperty("filename")] public string FileName { get { return (string)this["filename"]; } set { this["filename"] = value; } } }
2.创建配置文件代码 private static void WriteAppConfiguration() { try { ConfigurationSections configData = http://www.mamicode.com/new ConfigurationSections(); configData.FileName ="abc.txt"; System.Configuration.Configuration config =
ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None); config.Sections.Remove("ConfigurationSections"); config.Sections.Add("ConfigurationSections", configData); config.Save();
BusinessSpaceConfiguration bsconfigData = http://www.mamicode.com/new BusinessSpaceConfiguration(); bsconfigData.FileName ="def.txt"; System.Configuration.Configuration config1 =
ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None); config1.Sections.Remove("BusinessSpaceConfiguration"); config1.Sections.Add("BusinessSpaceConfiguration", bsconfigData); config1.Save(); } catch (Exception err) { Console.Write(err.Message); } }
3.生成的配置文件格式如下所示: <?xml version="1.0" encoding="utf-8"?> <configuration> <configSections> <section
type="ConsoleApplication1.BusinessSpaceConfiguration, ConsoleApplication1, Version=1.0.0.0,
Culture=neutral, PublicKeyToken=null" /> <section type="ConsoleApplication1.ConfigurationSections,
ConsoleApplication1, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" /> </configSections> <BusinessSpaceConfiguration filename="def.txt" /> <ConfigurationSections filename="abc.txt" /> </configuration>
4.读取应用程序配置文件 private static void ReadAppConfiguration() { ConfigurationSections obj1 = ConfigurationManager.GetSection("ConfigurationSections")
as ConfigurationSections; BusinessSpaceConfiguration obj2 = ConfigurationManager.GetSection
("BusinessSpaceConfiguration") as BusinessSpaceConfiguration; Console.WriteLine(obj1.FileName); Console.WriteLine(obj2.FileName);
}
自定义应用程序配置文件(app.config)
1. 配置文件概述: 应用程序配置文件是标准的 XML 文件,XML 标记和属性是区分大小写的。它是可以按需要更改的,开发人员可以使用配置文件来更改设置,而不必重编译应用程序。配置文件的根节点是configuration。我们经常访问的是appSettings,它是由.Net预定义配置节。我们经常使用的配置文件的架构是象下面的形式。先大概有个印象,通过后面的实例会有一个比较清楚的认识。下面的“配置节”可以理解为进行配置一个XML的节点。
常见配置文件模式:
<configuration> <configSections> //配置节声明区域,包含配置节和命名空间声明 <section> //配置节声明 <sectionGroup> //定义配置节组 <section> //配置节组中的配置节声明 <appSettings> //预定义配置节 <Custom element for configuration section> //配置节设置区域
2.只有appSettings节的配置文件及访问方法
下面是一个最常见的应用程序配置文件的例子,只有appSettings节。
<?xml version="1.0" encoding="utf-8"?> <configuration> <appSettings> <add key="connectionstring" value="http://www.mamicode.com/User Source=.;Password=;Initial Catalog=test;Provider=SQLOLEDB.1;" /> <add key="TemplatePATH" value="http://www.mamicode.com/Template" /> </appSettings> </configuration> 下面来看看这样的配置文件如何方法。
string _connectionString=ConfigurationSettings.AppSettings["connectionstring"];
使用ConfigurationSettings类的静态属性AppSettings就可以直接方法配置文件中的配置信息。这个属性的类型是NameValueCollection。
3.自定义配置文件 3.1 自定义配置节
一个用户自定义的配置节,在配置文件中分为两部分:一是在<configSections></configSections>配置节中声明配置节(上面配置文件模式中的“<section>”),另外是在<configSections></configSections >之后设置配置节(上面配置文件模式中的“<Custom element for configuration section>”),有点类似一个变量先声明,后使用一样。声明一个配置文件的语句如下: <section " type=" "/> <section>:声明新配置节,即可创建新配置节。
name:自定义配置节的名称。 type:自定义配置节的类型,主要包括System.Configuration.SingleTagSectionHandler、System.Configuration.DictionarySectionHandler、System.Configuration.NameValueSectionHandler。
不同的type不但设置配置节的方式不一样,最后访问配置文件的操作上也有差异。下面我们就举一个配置文件的
例子,让它包含这三个不同的type。
红色的地方是原帖没有提到的,如果编码的时候没有涉及的话,会出错 <?xml version="1.0" encoding="utf-8" ?> <configuration> <configSections> <section type="System.Configuration.SingleTagSectionHandler" name="Test1 "/> <section type="System.Configuration.DictionarySectionHandler" name="Test2"/> <section type="System.Configuration.NameValueSectionHandler" name="Test3" /> </configSections> <Test1 setting1="Hello" setting2="World"/> <Test2> <add key="Hello" value="http://www.mamicode.com/World" /> </Test2> <Test3> <add key="Hello" value="http://www.mamicode.com/World" /> </Test3> </configuration>
我们对上面的自定义配置节进行说明。在声明部分使用<section type="System.Configuration.SingleTagSectionHandler"/>声明了一个配置节它的名字叫Test1,类型为SingleTagSectionHandler。在设置配置节部分使用 <Test1 setting1="Hello" setting2="World"/>设置了一个配置节,它的第一个设置的值是Hello,第二个值是World,当然还可以有更多。其它的两个配置节和这个类似。 下面我们看在程序中如何访问这些自定义的配置节。我们用过ConfigurationSettings类的静态方法GetConfig来获取自定义配置节的信息。
public static object GetConfig(string sectionName);
下面是访问这三个配置节的代码:
//访问配置节Test1 IDictionary IDTest1 = (IDictionary)ConfigurationSettings.GetConfig("Test1"); string str = (string)IDTest1["setting1"] +" "+(string)IDTest1["setting2"]; MessageBox.Show(str); //输出Hello World
//访问配置节Test1的方法2 string[] values1=new string[IDTest1.Count]; IDTest1.Values.CopyTo(values1,0); MessageBox.Show(values1[0]+" "+values1[1]); //输出Hello World
//访问配置节Test2 IDictionary IDTest2 = (IDictionary)ConfigurationSettings.GetConfig("Test2"); string[] keys=new string[IDTest2.Keys.Count]; string[] values=new string[IDTest2.Keys.Count]; IDTest2.Keys.CopyTo(keys,0); IDTest2.Values.CopyTo(values,0); MessageBox.Show(keys[0]+" "+values[0]);
//访问配置节Test3
NameValueCollection 的命名空间:using System.Collections.Specialized NameValueCollection nc=(NameValueCollection)ConfigurationSettings.GetConfig("Test3"); MessageBox.Show(nc.AllKeys[0].ToString()+" "+nc["Hello"]); //输出Hello World 通过上面的代码我们可以看出,不同的type通过GetConfig返回的类型不同,具体获得配置内容的方式也不一样。
配置节处理程序 返回类型
SingleTagSectionHandler Systems.Collections.IDictionary
DictionarySectionHandler Systems.Collections.IDictionary
NameValueSectionHandler Systems.Collections.Specialized.NameValueCollection
3.2 自定义配置节组 配置节组是使用<sectionGroup>元素,将类似的配置节分到同一个组中。配置节组声明部分将创建配置节的包含元素,在<configSections>元素中声明配置节组,并将属于该组的节置于<sectionGroup>元素中。下面是一个包含配置节组的配置文件的例子:
<?xml version="1.0" encoding="utf-8" ?> <configuration> <configSections> <sectionGroup > <section type="System.Configuration.NameValueSectionHandler"/> </sectionGroup> </configSections> <TestGroup> <Test> <add key="Hello" value="http://www.mamicode.com/World"/> </Test> </TestGroup> </configuration> 下面是访问这个配置节组的代码: NameValueCollection nc=(NameValueCollection)ConfigurationSettings.GetConfig("TestGroup/Test"); MessageBox.Show(nc.AllKeys[0].ToString()+" "+nc["Hello"]); //输出Hello World
配置App.config
1. 向项目添加app.config文件:
右击项目名称,选择“添加”→“添加新建项”,在出现的“添加新项”对话框中,选择“添加应用程序配置文件”;如果项目以前没有配置文件,则默认的文件名称为“app.config”,单击“确定”。出现在设计器视图中的app.config文件为:
<?xmlversion="1.0"encoding="utf-8" ?> <configuration> </configuration>
在项目进行编译后,在bin\Debuge文件下,将出现两个配置文件(以本项目为例),一个名为“JxcManagement.EXE.config”,另一个名为“JxcManagement.vshost.exe.config”。第一个文件为项目实际使用的配置文件,在程序运行中所做的更改都将被保存于此;第二个文件为原代码“app.config”的同步文件,在程序运行中不会发生更改。
2. connectionStrings配置节:
请注意:如果您的SQL版本为2005 Express版,则默认安装时SQL服务器实例名为localhost\SQLExpress,须更改以下实例中“Data Source=localhost;”一句为“Data Source=localhost\SQLExpress;”,在等于号的两边不要加上空格。
<!--数据库连接串--> <connectionStrings> <clear /> <addname="conJxcBook" connectionString="Data Source=localhost;Initial Catalog=jxcbook;User providerName="System.Data.SqlClient" /> </connectionStrings>
3. appSettings配置节:
appSettings配置节为整个程序的配置,如果是对当前用户的配置,请使用userSettings配置节,其格式与以下配置书写要求一样。
<!--进销存管理系统初始化需要的参数--> <appSettings> <clear /> <addkey="userName"value="" /> <addkey="password"value="" /> <addkey="Department"value="" /> <addkey="returnValue"value="" /> <addkey="pwdPattern"value="" /> <addkey="userPattern"value="" /> </appSettings>
4.读取与更新app.config
请注意:要使用以下的代码访问app.config文件,除添加引用System.Configuration外,还必须在项目添加对System.Configuration.dll的引用。
4.1 读取connectionStrings配置节
///<summary> ///依据连接串名字connectionName返回数据连接字符串 ///</summary> ///<param ></param> ///<returns></returns> private static string GetConnectionStringsConfig(string connectionName) { string connectionString = ConfigurationManager.ConnectionStrings[connectionName].ConnectionString.ToString(); Console.WriteLine(connectionString); return connectionString; }
4.2 更新connectionStrings配置节
///<summary> ///更新连接字符串 ///</summary> ///<param >连接字符串名称</param> ///<param >连接字符串内容</param> ///<param >数据提供程序名称</param> private static void UpdateConnectionStringsConfig(string newName, string newConString, string newProviderName) { bool isModified = false; //记录该连接串是否已经存在 //如果要更改的连接串已经存在 if (ConfigurationManager.ConnectionStrings[newName] != null) { isModified = true; } //新建一个连接字符串实例 ConnectionStringSettings mySettings = new ConnectionStringSettings(newName, newConString, newProviderName); // 打开可执行的配置文件*.exe.config Configuration config = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None); // 如果连接串已存在,首先删除它 if (isModified) { config.ConnectionStrings.ConnectionStrings.Remove(newName); } // 将新的连接串添加到配置文件中. config.ConnectionStrings.ConnectionStrings.Add(mySettings); // 保存对配置文件所作的更改 config.Save(ConfigurationSaveMode.Modified); // 强制重新载入配置文件的ConnectionStrings配置节 ConfigurationManager.RefreshSection("ConnectionStrings"); }
4.3 读取appStrings配置节
///<summary> ///返回*.exe.config文件中appSettings配置节的value项 ///</summary> ///<param ></param> ///<returns></returns> private static string GetAppConfig(string strKey) { foreach (string key in ConfigurationManager.AppSettings) { if (key == strKey) { return ConfigurationManager.AppSettings[strKey]; } } return null; }
4.4 更新connectionStrings配置节
///<summary> ///在*.exe.config文件中appSettings配置节增加一对键、值对 ///</summary> ///<param ></param> ///<param ></param> private static void UpdateAppConfig(string newKey, string newValue) { bool isModified = false; foreach (string key in ConfigurationManager.AppSettings) { if(key==newKey) { isModified = true; } }
// Open App.Config of executable Configuration config = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None); // You need to remove the old settings object before you can replace it if (isModified) { config.AppSettings.Settings.Remove(newKey); } // Add an Application Setting. config.AppSettings.Settings.Add(newKey,newValue); // Save the changes in App.config file. config.Save(ConfigurationSaveMode.Modified); // Force a reload of a changed section. ConfigurationManager.RefreshSection("appSettings"); }
C# App.config 详解