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

  • [アーティクル]

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

configuration
  <system.diagnostics>
    <sources>
      <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> 要素を使用する前に <remove> 要素を使用して、トレース ソース TraceSourceApp の Listeners コレクションに console リスナーを追加する方法を示します。

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

関連項目