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

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

更新 : 2007 年 11 月

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

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

<clear/>

属性と要素

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

属性

なし

子要素

なし

親要素

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

解説

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

構成ファイル

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

使用例

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

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