<izleme dinleyicileri> için <<clear> Öğesi>

Makale
05/10/2023

Listeners İzleme için koleksiyonu temizler.

<Yapılandırma>
  <system.diagnostics>
    <Izleme>
      <Dinleyici>
        <Temizleyin>

Syntax

<clear/>

Öznitelikler ve Öğeler

Öznitelikler, alt ve üst öğeler aşağıdaki bölümlerde açıklanmaktadır.

Öznitelikler

Yok.

Alt Öğeler

Yok.

Üst Öğeler

Öğe	Açıklama
`configuration`	Her yapılandırma dosyasında yer alan ve ortak dil çalışma zamanı ve .NET Framework uygulamaları tarafından kullanılan kök öğe.
`system.diagnostics`	İletileri toplayan, depolayan ve yönlendiren izleme dinleyicilerini ve izleme anahtarının ayarlandığı düzeyi belirtir.
`trace`	İzleme iletilerini toplayan, depolayan ve yönlendiren dinleyicileri içerir.
`listeners`	İletileri toplayan, depolayan ve yönlendiren dinleyicileri içerir. Dinleyiciler izleme çıkışını uygun bir hedefe yönlendirir.

Açıklamalar

<clear> öğesi, izleme için koleksiyondaki Listeners tüm dinleyicileri kaldırır. öğesini kullanmadan <add> önce, koleksiyonda <clear> başka etkin dinleyici olmadığından emin olmak için öğesini kullanabilirsiniz.

( özelliğinde ListenersSystem.Diagnostics.Trace.Listeners.Clear()yöntemini Trace.Listeners çağırarak Clear koleksiyonu program aracılığıyla temizleyebilirsiniz.

Bu öğe makine yapılandırma dosyasında (Machine.config) ve uygulama yapılandırma dosyasında kullanılabilir.

Not

<clear> öğesi , , Debug.Fail Trace.Assertve Trace.Fail yöntemlerinin Listeners davranışını Debug.Assertdeğiştirerek öğesini koleksiyondan kaldırırDefaultTraceListener. Assert Bir veya Fail yönteminin çağrılması normalde ileti kutusunun görüntülenmesine neden olur. Ancak, ileti kutusu koleksiyonda Listeners değilse görüntülenmezDefaultTraceListener.

Örnek

Aşağıdaki örnekte, izleme için koleksiyona dinleyici console eklemek üzere öğesini kullanmadan <add> önce öğesinin Listeners nasıl kullanılacağı <clear> gösterilmektedir.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <clear/>  
        <add name="console"
          type="System.Diagnostics.ConsoleTraceListener" >  
          <filter type="System.Diagnostics.EventTypeFilter"
            initializeData="Error" />  
        </add>  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>