Aracılığıyla paylaş

<kaynak dinleyicileri><için <<ekleme> için filter> Öğesi>

  • Makale

İzleme kaynağı için koleksiyondaki bir dinleyiciye Listeners filtre ekler.

<Yapılandırma>
  <system.diagnostics>
    <sources>
      <source>
        <Dinleyici>
          <add>
            <filter>

Sözdizimi

<filter
  type="traceFilterClassName"
  initializeData="data" />

Öznitelikler ve Öğeler

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

Özellikler

Öznitelik Açıklama
type Gerekli öznitelik.

Sınıfından devralması TraceFilter gereken filtrenin türünü belirtir. Türün, türün özelliğine karşılık gelen ad alanı nitelenmiş adını veya özelliğine FullName karşılık AssemblyQualifiedName gelen derleme bilgileri de dahil olmak üzere tam tür adını kullanabilirsiniz. Tam tür adları hakkında bilgi için bkz . Tam Tür Adlarını Belirtme.
initializeData İsteğe bağlı öznitelik.

Belirtilen filtre sınıfı için oluşturucuya geçirilen dize.

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.
sources İzleme iletilerini başlatan izleme kaynaklarını içerir.
source İzleme iletilerini başlatan bir izleme kaynağı belirtir.
listeners İletileri toplayan, depolayan ve yönlendiren dinleyicileri içerir. Dinleyiciler izleme çıkışını uygun bir hedefe yönlendirir.
add İzleme kaynağı için koleksiyona Listeners bir dinleyici ekler.

Açıklamalar

<filter> öğesi, yalnızca sharedListeners> içinde tanımlanan bir <add> dinleyicinin adını değil dinleyicinin türünü belirten bir <izleme kaynağı dinleyicisi öğesinde bulunmalıdır. Dinleyici bir <sharedListeners> içinde tanımlanmışsa, söz konusu dinleyicinin filtresi bu öğede tanımlanmalıdır.

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

Örnek

Aşağıdaki örnekte, izleme kaynağı myTraceSourceiçin koleksiyondaki Listeners dinleyiciye console filtre eklemek için öğesinin nasıl kullanılacağı <filter> ve filtre olay düzeyinin olarak Errorbelirtilmesi gösterilmektedir.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="myTraceSource" switchName="SourceSwitch"
        switchType="System.Diagnostics.SourceSwitch"  >  
        <listeners>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener" >  
            <filter type="System.Diagnostics.EventTypeFilter"
              initializeData="Error" />  
          </add>  
          <remove name="Default" />  
        </listeners>  
      </source>  
    </sources>  
    <switches>  
      <add name="SourceSwitch" value="Warning" />  
    </switches>  
  </system.diagnostics>  
</configuration>

Ayrıca bkz.