EventProviderTraceListener Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bunun için TraceSource bir dinleyici ETW alt sistemine olayları yazar.
public ref class EventProviderTraceListener : System::Diagnostics::TraceListenerpublic class EventProviderTraceListener : System.Diagnostics.TraceListenertype EventProviderTraceListener = class
inherit TraceListenerPublic Class EventProviderTraceListener
Inherits TraceListener- Devralma
Örnekler
private static Guid providerId = new Guid("{B3F0C8FC-E8A8-4868-8901-1465E8A2F41B}");
EventProviderTraceListener listener = new EventProviderTraceListener(providerId.ToString(), "Test Listener", "::");
// You should use the All default level and control the level using the
// ETW session; otherwise, you may not log all the events requested by the
// session.
TraceSource source = new TraceSource("MyProvider", SourceLevels.All);
source.Listeners.Add(listener);
source.TraceData(TraceEventType.Warning | TraceEventType.Start, 2, new object[] { "abc", "def", true, 123 });
source.TraceEvent(TraceEventType.Warning, 12, "Provider guid: {0}", new object[] { providerId });
source.TraceInformation("string {0}, bool {1}, int {2}, ushort {3}", new object[] { "abc", false, 123, (UInt32)5 });
Açıklamalar
Kaynak olaydaki tüm olay verileri (izleme veya hata ayıklama), ETW alt sistemine dize olarak yazılır. Veri öğeleri virgül kullanılarak sınırlandırılır. Farklı bir sınırlayıcı belirtmek için özelliğini kullanın Delimiter .
Dinleyicinin System.Diagnostics.TraceSource eklenmesi, sağlayıcıyı ETW alt sistemine kaydeder. Olayları bir günlük dosyasına yazmak için Logman.exe yürütülebilir programı (veya benzeri) kullanarak bir ETW izleme oturumu oluşturmanız gerekir.
Olay verileri tek bir dize olduğundan dinleyiciden gelen olayları kullanmak için bildirime ihtiyacınız yoktur.
Olayları yazmak için yöntemlerini çağırdığınızda System.Diagnostics.TraceSource , bir System.Diagnostics.TraceEventType numaralandırma değeri geçirirsiniz. Numaralandırma hem düzey hem de anahtar sözcük değerleri içerir. EtW oturumundan bir izleme dinleyicisi sağlayıcısını etkinleştirdiğinizde, belirttiğiniz düzey değeri aşağıdaki System.Diagnostics.TraceEventType numaralandırma değerlerinden biriyle ilişkili değer olabilir:
Kritik (değer 1' dir)
Hata (değer 2)
Bilgi (değer 8'dir)
Ayrıntılı (değer 16)
Uyarı (değer 4'tür)
Oturum için belirttiğiniz anahtar sözcük değeri, aşağıdaki System.Diagnostics.TraceEventType numaralandırma değerlerinden biriyle ilişkili değer olabilir:
Özgeçmiş (değer 2.048'dir)
Başlangıç (değer 256' dır)
Stop (değer 512' dir)
Askıya alma (değer 1.024)
Aktarım (değer 4.096' dır)
Oluşturucular
| EventProviderTraceListener(String) |
Belirtilen sağlayıcı tanımlayıcısını EventProviderTraceListener kullanarak sınıfının yeni bir örneğini başlatır. |
| EventProviderTraceListener(String, String) |
Belirtilen sağlayıcı tanımlayıcısını EventProviderTraceListener ve dinleyicinin adını kullanarak sınıfının yeni bir örneğini başlatır. |
| EventProviderTraceListener(String, String, String) |
Belirtilen sağlayıcı tanımlayıcısını, dinleyicinin adını ve sınırlayıcıyı kullanarak sınıfının yeni bir örneğini EventProviderTraceListener başlatır. |
Özellikler
| Attributes |
Uygulama yapılandırma dosyasında tanımlanan özel izleme dinleyicisi özniteliklerini alır. (Devralındığı yer: TraceListener) |
| Delimiter |
ETW alt sistemine yazılan olay verilerini sınırlandırmak için kullanılan sınırlayıcıyı alır veya ayarlar. |
| Filter |
İzleme dinleyicisi için izleme filtresini alır veya ayarlar. (Devralındığı yer: TraceListener) |
| IndentLevel |
Girinti düzeyini alır veya ayarlar. (Devralındığı yer: TraceListener) |
| IndentSize |
Girintideki boşlukların sayısını alır veya ayarlar. (Devralındığı yer: TraceListener) |
| IsThreadSafe |
İzleme dinleyicisinin iş parçacığı güvenli olup olmadığını belirten bir değer alır. |
| Name |
Bu TraceListeneriçin bir ad alır veya ayarlar. (Devralındığı yer: TraceListener) |
| NeedIndent |
Çıkışı girintileyip girintilemeyeceğini belirten bir değer alır veya ayarlar. (Devralındığı yer: TraceListener) |
| TraceOutputOptions |
İzleme çıkışı seçeneklerini alır veya ayarlar. (Devralındığı yer: TraceListener) |
Yöntemler
| Close() |
Artık izleme veya hata ayıklama çıkışı almaması için çıkış akışını kapatır. |
| CreateObjRef(Type) |
Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject) |
| Dispose() |
TraceListener tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: TraceListener) |
| Dispose(Boolean) |
TraceListener tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır. (Devralındığı yer: TraceListener) |
| Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
| Fail(String) |
sınıfını uygularken oluşturduğunuz dinleyiciye bir hata iletisi yayar TraceListener . (Devralındığı yer: TraceListener) |
| Fail(String, String) |
Sınıfını uygularken oluşturduğunuz dinleyiciye bir hata iletisi ve ayrıntılı bir hata iletisi yayar TraceListener . |
| Flush() |
Çıkış arabelleği boşaltır. |
| GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
| GetLifetimeService() |
Geçersiz.
Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject) |
| GetSupportedAttributes() |
İzleme dinleyicisi tarafından desteklenen özel öznitelikleri alır. |
| GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
| InitializeLifetimeService() |
Geçersiz.
Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject) |
| MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
| MemberwiseClone(Boolean) |
Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject) |
| ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
İzleme bilgilerini, veri nesnesini ve olay bilgilerini dinleyiciye özel çıktıya yazar. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
İzleme bilgilerini, veri nesnesini ve olay bilgilerini dinleyiciye özel çıktıya yazar. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
dinleyiciye özgü çıkışa izleme ve olay bilgileri yazar. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
İzleme bilgilerini, bir iletiyi ve olay bilgilerini dinleyiciye özel çıkışa yazar. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Dinleyiciye özgü çıktıya, biçimlendirilmiş bir nesne dizisi ve olay bilgileri olan izleme bilgilerini yazar. |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
İzleme bilgilerini, bir iletiyi, ilgili etkinlik kimliğini ve olay bilgilerini dinleyiciye özel çıktıya yazar. |
| Write(Object) |
nesnesinin ToString() yönteminin değerini sınıfını uygularken oluşturduğunuz dinleyiciye TraceListener yazar. (Devralındığı yer: TraceListener) |
| Write(Object, String) |
Sınıfını uygularken oluşturduğunuz dinleyiciye bir kategori adı ve nesnenin ToString() yönteminin TraceListener değerini yazar. (Devralındığı yer: TraceListener) |
| Write(String) |
Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen iletiyi türetilmiş sınıfta oluşturduğunuz dinleyiciye yazar. |
| Write(String, String) |
Sınıfını uygularken TraceListener oluşturduğunuz dinleyiciye bir kategori adı ve ileti yazar. (Devralındığı yer: TraceListener) |
| WriteIndent() |
Bu sınıfı uygularken oluşturduğunuz dinleyiciye girintiyi yazar ve özelliğini olarak |
| WriteLine(Object) |
nesnesinin ToString() yönteminin değerini sınıfını uygularken oluşturduğunuz dinleyiciye TraceListener yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TraceListener) |
| WriteLine(Object, String) |
Sınıfını uygularken oluşturduğunuz dinleyiciye bir kategori adı ve nesnenin ToString() yönteminin TraceListener değerini yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TraceListener) |
| WriteLine(String) |
Türetilmiş bir sınıfta geçersiz kılındığında, türetilmiş sınıfta oluşturduğunuz dinleyiciye bir ileti yazar ve ardından bir satır sonlandırıcısı yazar. |
| WriteLine(String, String) |
Sınıfı uygularken TraceListener oluşturduğunuz dinleyiciye bir kategori adı ve ileti yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TraceListener) |
