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

Makale
04/06/2024

İzleme kaynağı için koleksiyona Listeners bir dinleyici ekler.

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

Sözdizimi

<add name="name"
  type="TraceListenerClassName, 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, koleksiyondaki `sharedListeners` bir dinleyiciye başvurmadığınız sürece, bu durumda yalnızca ada göre başvurmanız gerekir (örn. Örn. 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. ConfigurationException sınıfı bir dize alan bir oluşturucuya sahip değilse oluşturulur.
`name`	İsteğe bağlı öznitelik. Dinleyicinin adını belirtir.
`traceOutputOptions`	İsteğe bağlı öznitelik. İzleme dinleyicisi TraceOutputOptions için özellik değerini belirtir.
[özel öznitelikler]	İsteğe bağlı öznitelikler. Bu dinleyici için yöntemi tarafından tanımlanan dinleyiciye GetSupportedAttributes özgü özniteliklerin değerini belirtir. Delimiter , sınıfına özgü DelimitedListTraceListener ek bir öznitelik örneğidir.

Alt Öğeler

Öğe	Açıklama
<filter>	İzleme kaynağı 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.
`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 belirtir.

Açıklamalar

.NET Framework ile gönderilen dinleyici sınıfları sınıfından TraceListener türetilir.

İzleme dinleyicisinin özniteliğini belirtmezseniz name , Name izleme dinleyicisinin özelliği varsayılan olarak boş bir dize ("") olarak adlandırılır. Uygulamanızın tek bir dinleyicisi varsa, ad belirtmeden ekleyebilirsiniz ve ad için boş bir dize belirterek bunu kaldırabilirsiniz. Ancak, uygulamanızın birden fazla dinleyicisi varsa, her izleme dinleyicisi için benzersiz bir ad belirtmeniz gerekir. Bu ad, koleksiyondaki TraceSource.Listeners tek tek izleme dinleyicilerini tanımlamanıza ve yönetmenize olanak tanır.

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.

ö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
System.Diagnostics.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.
System.Diagnostics.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ı.
System.Diagnostics.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, izleme kaynağının dinleyicilerini console ve textListener koleksiyonuna Listeners eklemek için öğelerin nasıl kullanılacağı <add> gösterilmektedirTraceSourceApp. 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>

Share via