<source> の <listeners> の <clear> 要素

  • [アーティクル]

トレース ソースの Listeners コレクションを消去します。

configuration
  <system.diagnostics>
    <sources>
      <source>
        <listeners>
          <clear>

構文

<clear/>

属性および要素

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

属性

なし。

子要素

なし。

親要素

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

解説

<clear> 要素は、トレース ソースの Listeners コレクションからすべてのリスナーを削除します (DefaultTraceListener を含む)。 <add> 要素を使用する前に <clear> 要素を使用すると、コレクション内に他にアクティブなリスナーが存在しないようにできます。

構成ファイル

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

例

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

<configuration>  
  <system.diagnostics>  
    <sources>  
       <source name="TraceSourceApp" switchName="sourceSwitch"
         switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <clear/>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener"/>  
          <add name="textListener"/>  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add name="textListener"
        type="System.Diagnostics.TextWriterTraceListener"
        initializeData="myListener.log"/>  
    </sharedListeners>  
    <switches>  
      <add name="sourceSwitch" value="Warning"/>  
    </switches>  
  </system.diagnostics>  
</configuration>

関連項目