configSections の clear 要素 (全般設定スキーマ)

2011-08-09

継承したセクションとセクショングループへのすべての参照を削除し、現在の section 要素と sectionGroup 要素によって追加されたセクションとセクショングループだけを有効にします。

<clear />

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

なし。

子要素

なし。

親要素

要素	説明
configuration	共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素を指定します。
configSections	構成セクションと名前空間の宣言を指定します。
sectionGroup	構成セクションハンドラーと構成セクションの間の関連付けを定義します。

解説

clear 要素は、継承したセクションとセクショングループへのすべての参照を削除し、現在の section 要素と sectionGroup 要素によって追加されたセクションとセクショングループだけを有効にします。

ハンドラーの参照が削除された後に、構成ファイルが構成セクションを使用しようとすると、ASP.NET により "認識できない構成セクション element_name" というサーバーエラーが発行されます。

使用例

アプリケーション構成ファイルで clear 要素を使用して、Machine.config ファイルで定義済みのセクションを削除するコード例を次に示します。

Machine.config ファイルの次のコードでは、アプリケーション構成ファイルの前に読み取られる sampleSection と anotherSampleSection の 2 つのセクションが宣言されます。

<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>

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

<section name="anotherSection"

type="System.Configuration.NameValueSectionHandler" />

</configSections>

</configuration>

要素情報

構成セクションハンドラー	該当なし
構成メンバー	Clear() Clear()
構成できる場所	Machine.config ルートレベルの Web.config アプリケーションレベルの Web.config 仮想ディレクトリレベルまたは物理ディレクトリレベルの Web.config
要件	Microsoft Internet Information Services (IIS) バージョン 5.0、5.1、または 6.0 .NET Framework Version 1.0、1.1、または 2.0 Microsoft Visual Studio 2003 または Visual Studio 2005