次の方法で共有


NameValueSectionHandler および DictionarySectionHandler の <clear> 要素

セクションで以前に定義したすべての設定を消去します。

configuration
   <sectionName>
     <clear>

構文

<clear />

属性

なし

親要素

説明
<sectionName> 要素 NameValueSectionHandler クラスと DictionarySectionHandler クラスを使用するカスタム構成セクションの設定を定義します。

子要素

なし

解説

<clear> 要素を使用して、構成ファイル階層の上位レベルで定義されているすべての設定をアプリケーションから削除できます。

この例では、マシン構成ファイルとアプリケーション構成ファイルを定義し、アプリケーション構成ファイルで <clear> 要素を使用して、マシン構成ファイルで以前に定義したセクションをクリアする方法を示します。

次のマシン構成ファイルのコードでは、<mySection> セクションを宣言しています。

<!-- Machine.config file -->
<configuration>
  <configSections>
    <section name="mySection" type="System.Configuration.NameValueSectionHandler,System" />
  </configSections>
  <mySection>
    <add key="key1" value="value1" />
    <add key="key2" value="value2" />
  </mySection>
</configuration>

次のアプリケーション構成ファイルのコードでは、<mySection> からすべての設定を削除します。 アプリケーションでは、マシン構成ファイルの <mySection> セクションで宣言された設定を取得できません。

<!-- Application configuration file -->
<configuration>
  <mySection>
    <clear/>
  </mySection>
</configuration>

構成ファイル

この要素は、アプリケーション構成ファイル、マシン構成ファイル (Machine.config)、およびアプリケーション ディレクトリ レベルではない Web.config ファイルで使用できます。

関連項目