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

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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

<configuration> 要素
   <system.diagnostics> 要素
     <sources> 要素
       <source> 要素
         <trace> の <listeners> 要素
           <source> の <listeners> の <remove> 要素

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