<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>
関連項目
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET