<source> の <listeners> の <remove> 要素

2011-08-09

トレースソースの Listeners コレクションからリスナーを削除します。

<remove name="listenerName" />

属性および要素

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

属性

属性	説明
name	必須の属性です。 Listeners コレクションから削除するリスナーの名前。

子要素

なし。

親要素

要素	説明
configuration	共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。
system.diagnostics	メッセージを収集、格納、およびルーティングするトレースリスナーとトレーススイッチを設定するレベルを指定します。
sources	トレースメッセージを開始するトレースソースを保持します。
source	トレースメッセージを開始するトレースソースを指定します。
listeners	メッセージを収集、格納、およびルーティングするリスナーを指定します。

解説

<remove> 要素は、トレースソースの Listeners コレクションから指定したリスナーを削除します。

TraceSource インスタンスの Listeners プロパティで Remove メソッドを呼び出すことによって、トレースソースの Listeners コレクションから要素をプログラムで削除できます。

この要素は、マシン構成ファイル (Machine.config) およびアプリケーション構成ファイルで使用できます。

使用例

<add> 要素を使用してリスナー console をトレースソース TraceSourceApp の Listeners コレクションに追加する前に、<remove> 要素を使用する方法を次の例に示します。

<configuration>
  <system.diagnostics>
    <sources>
      <source name="TraceSourceApp" switchName="sourceSwitch" 
         switchType="System.Diagnostics.SourceSwitch" >
         <listeners>
           <remove name="Default"/>
           <add name="console" 
             type="System.Diagnostics.ConsoleTraceListener" />
         </listeners>
      </source>
    </sources>
  </system.diagnostics>
</configuration>