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

[アーティクル]
05/27/2012

[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]

継承したセクションおよびセクショングループへの参照を削除します。

<remove 
   name="section name" 
/>

属性および要素

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

属性

属性	Description
name	必須の String 属性です。削除するセクションまたはセクショングループの名前を指定します。これは、参照を追加した section 要素または sectionGroup 要素の name 属性と同じです。

子要素

なし。

親要素

要素	Description
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>

要素情報

構成セクションハンドラー	該当なし
構成メンバー	Remove(String) Remove(String)
構成できる場所	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

参照

Share via

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

属性および要素

属性

子要素

親要素

解説

使用例

要素情報

参照

Reference

概念

その他の技術情報

その他のリソース