次の方法で共有

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 クラスを使用するセクションを宣言する例を示します。カスタム要素は、DictionarySectionHandler クラスで読み取る設定を指定する <dictionarySample> と NameValueSectionHandler クラスで読み取る設定を指定する <mySection> です。

<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 ファイルで使用できます。

参照

構成セクション スキーマ | 構成セクションの設定