configSections の clear 要素 (全般設定スキーマ)
[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]
継承したセクションとセクション グループへのすべての参照を削除し、現在の section 要素と sectionGroup 要素によって追加されたセクションとセクション グループだけを有効にします。
<clear />
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
なし。
子要素
なし。
親要素
要素 |
Description |
---|---|
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 の設定は使用できます。
<configuration>
<configSections>
<clear/>
<section name="anotherSection"
type="System.Configuration.NameValueSectionHandler" />
</configSections>
</configuration>
要素情報
構成セクション ハンドラー |
該当なし |
構成メンバー |
|
構成できる場所 |
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 |
参照
Reference
configSections の sectionGroup 要素 (全般設定スキーマ)
configSections の section 要素 (全般設定スキーマ)
configSections の remove 要素 (全般設定スキーマ)
概念
ASP.NET Configuration File Hierarchy
Format of ASP.NET Configuration Files