共用方式為

NameValueSectionHandler 和 DictionarySectionHandler 的自訂項目

  • 發行項

定義使用 NameValueSectionHandler 或 DictionarySectionHandler 類別的自訂組態區段的設定。

<configuration>
<sectionName>

<sectionName> </sectionName>

子項目

項目 說明
NameValueSectionHandler 和 DictionarySectionHandler 的 <add> 項目 加入自訂的設定。
NameValueSectionHandler 和 DictionarySectionHandler 的 <remove> 項目 移除先前定義的設定。
NameValueSectionHandler 和 DictionarySectionHandler 的 <clear> 項目 清除區段中所有先前定義的設定。

備註

<sectionName> 項目是由 <configSections> 項目中 <section> 標記所定義的自訂項目。

下列表格顯示 ConfigurationSettings.GetConfig 方法為每個組態區段處理常式所傳回的物件型別。

組態區段處理常式 傳回型別
DictionarySectionHandler Systems.Collections.IDictionary
NameValueSectionHandler Systems.Collections.Specialized.NameValueCollection

範例

下列範例顯示如何宣告使用 DictionarySectionHandler 和 NameValueSectionHandler 類別的區段。自訂項目分別是 <dictionarySample> (其包含 DictionarySectionHandler 類別所讀取的設定) 和 <mySection> (其包含 NameValueSectionHandler 類別所讀取的設定)。

<configuration>
   <configSections>
      <section name="dictionarySample"
         type="System.Configuration.DictionarySectionHandler,System"/>
      <sectionGroup name="mySectionGroup">
         <section name="mySection"
            type="System.Configuration.NameValueSectionHandler,System" />
      </sectionGroup>
   </configSections>
   <dictionarySample>
      <add key="myKey" value="myValue"/>
   </dictionarySample>
   <mySectionGroup>
      <mySection>
         <add key="key1" value="value1" />
      </mySection>
   </mySectionGroup>
</configuration>

組態檔

這個項目可以在不是位於應用程式目錄層級的應用程式組態檔、電腦組態檔 (Machine.config) 和 Web.config 檔案中使用。

請參閱

組態區段結構描述 | 組態區段設定