<sharedListeners için <add> Öğesi>

Makale
04/06/2024

Koleksiyona sharedListeners bir dinleyici ekler. sharedListeners, herhangi <bir kaynağın> veya< izlemenin> başvurabileceği bir dinleyici koleksiyonudur. Varsayılan olarak, koleksiyondaki sharedListeners dinleyiciler bir Listeners koleksiyona yerleştirilmemiştir. Kaynağa veya izlemeye <>>ada göre eklenmelidir.< Koleksiyondaki sharedListeners dinleyicileri çalışma zamanında kodda almak mümkün değildir.

<Yapılandırma>
  <system.diagnostics>
    <sharedListeners>
      <add>

Sözdizimi

<add name="name"
  type="TraceListenerClassName, Version, Culture, PublicKeyToken"  
  initializeData="data"
  traceOutputOptions = "None"
/>

Öznitelikler ve Öğeler

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

Özellikler

Öznitelik	Açıklama
`name`	Gerekli öznitelik. Paylaşılan dinleyiciyi bir `Listeners` koleksiyona eklemek için kullanılan dinleyicinin adını belirtir.
`type`	Gerekli öznitelik. Dinleyicinin türünü belirtir. Tam Tür Adlarını Belirtme bölümünde belirtilen gereksinimleri karşılayan bir dize kullanmanız gerekir.
`initializeData`	İsteğe bağlı öznitelik. Belirtilen sınıf için oluşturucuya geçirilen dize.
`traceOutputOptions`	İsteğe bağlı öznitelik. İzleme çıkışına yazılacak verileri gösteren bir veya daha fazla TraceOptions numaralandırma üyesinin dize gösterimi. Birden çok öğe virgülle ayrılır. Varsayılan değer "Hiçbiri"dir.

Alt Öğeler

Öğe	Açıklama
<filter>	Koleksiyondaki `sharedListeners` bir dinleyiciye filtre ekler.

Ü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.
`sharedListeners`	Herhangi bir kaynak veya izleme öğesinin başvurabileceği dinleyici koleksiyonu.

Açıklamalar

.NET Framework ile gönderilen dinleyici sınıfları sınıfından TraceListener türetilir. özniteliğinin name değeri, paylaşılan dinleyiciyi bir izleme veya izleme kaynağı için bir Listeners koleksiyona eklemek için kullanılır. özniteliğinin initializeData değeri, oluşturduğunuz dinleyicinin türüne bağlıdır. Tüm izleme dinleyicileri belirtmenizi initializeDatagerektirmez.

Not

özniteliğini initializeData kullandığınızda, "'initializeData' özniteliği bildirilmedi" derleyici uyarısını alabilirsiniz. Bu uyarının nedeni, yapılandırma ayarlarının özniteliğini tanımayan soyut temel sınıfına TraceListenerinitializeData göre doğrulanmasıdır. Genellikle, parametre alan bir oluşturucuya sahip izleme dinleyicisi uygulamaları için bu uyarıyı yoksayabilirsiniz.

Aşağıdaki tabloda .NET Framework'e dahil edilen izleme dinleyicileri gösterilir ve özniteliklerinin initializeData değeri açıklanır.

dinleyici sınıfını izleme	initializeData öznitelik değeri
ConsoleTraceListener	`useErrorStream` Oluşturucunun ConsoleTraceListener değeri. standart hata akışına `initializeData` izleme ve hata ayıklama çıkışı yazmak için özniteliğini "`true`" olarak ayarlayın; standart çıkış akışına yazmak için "`false`" olarak ayarlayın.
DelimitedListTraceListener	Yazma işleminin olduğu dosyanın DelimitedListTraceListener adı.
System.Diagnostics.EventLogTraceListener	Mevcut bir olay günlüğü kaynağının adı.
System.Diagnostics.EventSchemaTraceListener	Yazma işleminin yaptığı EventSchemaTraceListener dosyanın adı.
System.Diagnostics.TextWriterTraceListener	Yazma işleminin yaptığı TextWriterTraceListener dosyanın adı.
XmlWriterTraceListener	Yazma işleminin yaptığı XmlWriterTraceListener dosyanın adı.

Yapılandırma Dosyası

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

Örnek

Aşağıdaki örnekte, öğesini koleksiyona eklemektextListenerTextWriterTraceListeneriçin öğelerin nasıl kullanılacağı <add> gösterilmektedirsharedListeners. textListener, izleme kaynağının TraceSourceAppkoleksiyonuna Listeners ada göre eklenir. Dinleyici, textListener izleme çıkışını dosyaya myListener.log yazar.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="TraceSourceApp" switchName="sourceSwitch"
        switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener"/>  
          <add name="textListener"/>  
          <remove name="Default"/>  
        </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>

Aracılığıyla paylaş