configSections の remove 要素 (全般設定スキーマ)
更新 : 2007 年 11 月
継承したセクションおよびセクション グループへの参照を削除します。
configuration 要素 (全般設定スキーマ)
configSections 要素 (全般設定スキーマ)
configSections の remove 要素 (全般設定スキーマ)
configuration 要素 (全般設定スキーマ)
configSections 要素 (全般設定スキーマ)
configSections の sectionGroup 要素 (全般設定スキーマ)
configSections の remove 要素 (全般設定スキーマ)
<remove
name="section name"
/>
属性と要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
説明 |
|---|---|
name |
必須の String 属性です。 削除するセクションまたはセクション グループの名前を指定します。これは、参照を追加した section 要素または sectionGroup 要素の name 属性と同じです。 |
子要素
なし。
親要素
要素 |
説明 |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework ベースのアプリケーションで使用されるすべての構成ファイルで必要なルート要素です。 |
configSections |
構成セクションと名前空間の宣言を指定します。 |
sectionGroup |
構成セクション ハンドラと構成セクションの間の関連付けを定義します。 |
解説
remove 要素は、継承したセクションまたはセクション グループへの参照を削除します。新しいセクションおよびセクション グループは、section 要素および sectionGroup 要素を使用することによって、現在の構成ファイルに格納されているコレクションに追加できます。
ハンドラの参照が削除された後に、構成ファイルが構成セクションを使用しようとすると、ASP.NET により "認識できない構成セクション element_name" というサーバー エラーが発行されます。
使用例
アプリケーション構成ファイルで remove 要素を使用して、Machine.config ファイルで定義済みのセクションを削除するコード例を次に示します。
次の Machine.config ファイルのコードでは、sampleSection という名前のセクションを宣言しています。
<configuration>
<configSections>
<section name="sampleSection"
type="System.Configuration.SingleTagSectionHandler" />
</configSections>
<sampleSection setting1="Value1" setting2="value two"
setting3="third value" />
</configuration>
sampleSection セクションを削除するアプリケーション構成ファイルの例は、次のとおりです。削除後、アプリケーションは sampleSection の設定を取得できません。ハンドラの参照が削除された後に、構成ファイルが構成セクションを使用しようとすると、ASP.NET により "認識できない構成セクション element_name" というサーバー エラーが発行されます。
<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 |
参照
概念
参照
configSections の sectionGroup 要素 (全般設定スキーマ)
configSections の section 要素 (全般設定スキーマ)
configSections の clear 要素 (全般設定スキーマ)