<sharedListeners için <add> Öğesi>
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 initializeData
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ö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 eklemektextListener
TextWriterTraceListeneriçin öğelerin nasıl kullanılacağı <add>
gösterilmektedirsharedListeners
. textListener
, izleme kaynağının TraceSourceApp
koleksiyonuna 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>
Ayrıca bkz.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin