自訂應用程式設定檔（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