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

Makale
04/06/2024

Dinleyiciler koleksiyonuna bir dinleyici ekler.

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

Sözdizimi

<add name="name"
     type="trace listener class name, Version, Culture, PublicKeyToken"  
     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. 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.
Adı	İsteğe bağlı öznitelik. Dinleyicinin adını belirtir.

Alt Öğeler

Öğe	Açıklama
<filter>	İzleme için koleksiyondaki bir dinleyiciye `Listeners` 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.
`listeners`	İletileri toplayan, depolayan ve yönlendiren bir dinleyici belirtir. Dinleyiciler izleme çıkışını uygun bir hedefe yönlendirir.
`system.diagnostics`	ASP.NET yapılandırma bölümünün kök öğesini belirtir.
`trace`	İzleme iletilerini toplayan, depolayan ve yönlendiren dinleyicileri içerir.

Açıklamalar

Debug ve Trace sınıfları aynı Dinleyici koleksiyonunu paylaşır. Bu sınıflardan birinde koleksiyona bir dinleyici nesnesi eklerseniz, diğer sınıf aynı dinleyiciyi kullanır. Dinleyici sınıfları' ndan TraceListenertüretilir.

İzleme dinleyicisinin name özniteliğini belirtmezseniz, Name izleme dinleyicisinin özniteliği varsayılan olarak boş bir dize ("") olur. Uygulamanızın tek bir dinleyicisi varsa, ad belirtmeden ekleyebilir ve ad için boş bir dize belirterek kaldırabilirsiniz. Ancak, uygulamanızın birden fazla dinleyicisi varsa, ve koleksiyonları içindeki Listeners Listeners tek tek izleme dinleyicilerini tanımlamanıza ve yönetmenize olanak tanıyan her izleme dinleyicisi için benzersiz adlar belirtmeniz gerekir.

Not

Aynı türde ve aynı ada sahip birden fazla izleme dinleyicisi eklemek, koleksiyona bu tür ve ad için yalnızca bir izleme dinleyicisi eklenmesine Listeners neden olur. Ancak, program aracılığıyla koleksiyona Listeners birden çok özdeş dinleyici ekleyebilirsiniz.

initializeData özniteliğinin değeri, oluşturduğunuz dinleyicinin türüne bağlıdır. Tüm izleme dinleyicileri initializeData belirtmenizi gerektirmez.

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österilmektedir ve initializeData özniteliklerinin değeri açıklanmaktadır.

dinleyici sınıfını izleme	initializeData öznitelik değeri
System.Diagnostics.ConsoleTraceListener	`useErrorStream` Oluşturucunun ConsoleTraceListener değeri. `initializeData` İzleme yazmak ve çıkış hatalarını ayıklamak için özniteliğini "`true`" olarak Console.Errorayarlayın; öğesine yazmak için Console.Out"`false`" yazın.
System.Diagnostics.DelimitedListTraceListener	Yazma işleminin olduğu dosyanın DelimitedListTraceListener adı.
System.Diagnostics.EventLogTraceListener	Mevcut bir olay günlüğü kaynağının adı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ı.
System.Diagnostics.XmlWriterTraceListener	Yazma işleminin yaptığı XmlWriterTraceListener dosyanın adı.

Örnek

Aşağıdaki örnekte, dinleyicileri ve Dinleyiciler MyListener koleksiyonuna eklemek için add> öğelerinin nasıl kullanılacağı< gösterilmektedir.MyEventListener MyListener adlı MyListener.log bir dosya oluşturur ve çıktıyı dosyaya yazar. MyEventListener olay günlüğünde bir girdi oluşturur.

<configuration>  
   <system.diagnostics>  
      <trace autoflush="true" indentsize="0">  
         <listeners>  
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />  
            <add name="MyEventListener"  
                 type="System.Diagnostics.EventLogTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"                 initializeData="MyConfigEventLog"/>  
            <add name="configConsoleListener"  
                 type="System.Diagnostics.ConsoleTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

Aracılığıyla paylaş