<configSections> の <clear> 要素

以前に定義したセクションとセクション グループをすべて消去します。

<clear/>

解説

<clear> 要素は、現在の構成ファイルまたは構成ファイル階層の上位レベルで既に定義されているすべてのセクションおよびセクション グループをアプリケーションから削除します。

例

アプリケーション構成ファイルで <clear> 要素を使用して、マシン構成ファイルで定義済みのセクションを解除する例を示します。

2 つのセクション <sampleSection> と <anotherSampleSection> を定義するマシン構成ファイルのコードは、次のとおりです。これは、アプリケーション構成ファイルよりも先に読み取られます。

<!-- Machine.config file. -->
<configuration>
   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
      <section name="anotherSampleSection"
               type="System.Configuration.NameValueSectionHandler" />
   </configSections>
   <sampleSection setting1="Value1" setting2="value two" 
                  setting3="third value" />
</configuration>

すべての宣言済みセクションを消去するアプリケーション構成ファイルのコードは、次のとおりです。マシン構成ファイルで宣言されていたどちらのセクションの設定も、アプリケーションで使用または取得できません。ただし、<anotherSection> の設定は、<clear> 要素の後で定義されているため使用できます。

<!-- Application configuration file. -->
<configuration>
   <configSections>
      <clear/>
      <section name="anotherSection"
               type="System.Configuration.NameValueSectionHandler" />
    </configSections>
</configuration>

構成ファイル

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

参照

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