自訂應用程式設定檔（app.config） (ZZ)

自訂應用程式設定檔（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="User ID=sa;Data Source=.;Password=;Initial Catalog=test;Provider=SQLOLEDB.1;" />
         <add key="TemplatePATH" value="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 name=" " 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 name="Test1" type="System.Configuration.SingleTagSectionHandler"/>
         <section name="Test2" type="System.Configuration.DictionarySectionHandler"/>
         <section name="Test3" type="System.Configuration.NameValueSectionHandler" />
     </configSections>
    
     <Test1 setting1="Hello" setting2="World"/>
     <Test2>
         <add key="Hello" value="World" />
     </Test2>
     <Test3>
         <add key="Hello" value="World" />
     </Test3>    
</configuration>

我們對上面的自訂配置節進行說明。在聲明部分使用<section name="Test1" 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 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 name="TestGroup">
             <section name="Test" type="System.Configuration.NameValueSectionHandler"/>
         </sectionGroup>
     </configSections>
    
     <TestGroup>
         <Test>
             <add key="Hello" value="World"/>
         </Test>
     </TestGroup>
</configuration>
下面是訪問這個配置節組的代碼：
NameValueCollection nc=(NameValueCollection)ConfigurationSettings.GetConfig("TestGroup/Test");
MessageBox.Show(nc.AllKeys[0].ToString()+" "+nc["Hello"]);     //輸出Hello World