EventLogTraceListener 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.
İzleme veya hata ayıklama çıkışını bir öğesine yönlendiren basit bir EventLogdinleyici sağlar.
public ref class EventLogTraceListener sealed : System::Diagnostics::TraceListenerpublic sealed class EventLogTraceListener : System.Diagnostics.TraceListenertype EventLogTraceListener = class
inherit TraceListenerPublic NotInheritable Class EventLogTraceListener
Inherits TraceListener- Devralma
Örnekler
Aşağıdaki örnek, bir olay günlüğüne çıkış gönderen bir izleme dinleyicisi oluşturur. İlk olarak kod, kaynağını myEventLogSourcekullanan yeni EventLogTraceListener bir oluşturur. Ardından, myTraceListener koleksiyona Trace.Listeners eklenir. Son olarak, örnek nesneye Listeners bir çıkış satırı gönderir.
int main()
{
#if defined(TRACE)
// Create a trace listener for the event log.
EventLogTraceListener^ myTraceListener =
gcnew EventLogTraceListener( "myEventLogSource" );
// Add the event log trace listener to the collection.
Trace::Listeners->Add( myTraceListener );
// Write output to the event log.
Trace::WriteLine( "Test output" );
#endif
}
// Create a trace listener for the event log.
EventLogTraceListener myTraceListener = new EventLogTraceListener("myEventLogSource");
// Add the event log trace listener to the collection.
Trace.Listeners.Add(myTraceListener);
// Write output to the event log.
Trace.WriteLine("Test output");
Overloads Public Shared Sub Main(args() As String)
' Create a trace listener for the event log.
Dim myTraceListener As New EventLogTraceListener("myEventLogSource")
' Add the event log trace listener to the collection.
Trace.Listeners.Add(myTraceListener)
' Write output to the event log.
Trace.WriteLine("Test output")
End Sub
Açıklamalar
bunun EventLogTraceListener bir örneği , Trace.Listenersveya koleksiyonlarına Debug.Listenerseklenerek izleme veya TraceSource.Listeners hata ayıklama çıktısı bir öğesine EventLoggönderilebilir. Örneği kodunuza ekleyebilir veya .NET Framework bir uygulama için bunu uygulama yapılandırma dosyasında belirtebilirsiniz.
.NET Framework uygulama yapılandırma dosyası kullanarak eklemek EventLogTraceListener için, uygulamanızın adına karşılık gelen dosyayı düzenleyin. Bu dosyada, bir tür için bir System.Diagnostics.EventLogTraceListener öğe ekleyin. Aşağıdaki örnek adlı bir EventLogTraceListener nesneyi myListener koleksiyona Trace.Listeners ekler. parametresi, initializeData oluşturucuya geçirilecek olay günlüğü kaynağının EventLogTraceListener(String) adını belirtir.
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="myListener"
type="System.Diagnostics.EventLogTraceListener"
initializeData="TraceListenerLog" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
Not
Source Örnekle EventLogTraceListener ilişkilendirilmiş olay günlüğü için mevcut değilse, yeni bir olay kaynağı oluşturulur. Windows Vista, Windows XP Professional veya Windows Server 2003'te olay kaynağı oluşturmak için yönetici ayrıcalıklarına sahip olmanız gerekir.
Bu gereksinimin nedeni, olay kaynağının benzersiz olup olmadığını belirlemek için güvenlik de dahil olmak üzere tüm olay günlüklerinin aranması gerektiğidir. Windows Vista'da kullanıcıların güvenlik günlüğüne erişim izni yoktur; bu nedenle, bir SecurityException oluşturulur.
Windows Vista'da Kullanıcı Hesabı Denetimi (UAC), bir kullanıcının ayrıcalıklarını belirler. Yerleşik Yöneticiler grubunun bir üyesi iseniz, size iki çalışma zamanı erişim belirteci atanır: Standart kullanıcı erişim belirteci ve yönetici erişim belirteci. Varsayılan olarak, standart kullanıcı rolünde olursunuz. Güvenlik günlüğüne erişen kodu yürütmek için öncelikle ayrıcalıklarınızı standart kullanıcıdan yöneticiye yükseltmeniz gerekir. Bir uygulamayı başlattığınızda, uygulama simgesine sağ tıklayıp yönetici olarak çalıştırmak istediğinizi belirterek bunu yapabilirsiniz.
sınıfı, izleme veya hata ayıklama çıkışını EventLog alan olay günlüğünü almak veya ayarlamak için özelliğini ve Name adını EventLogTraceListenertutacak özelliğini sağlar.
Close yöntemi, artık izleme veya hata ayıklama çıkışı almaması için olay günlüğünü kapatır. Write ve WriteLine yöntemleri olay günlüğüne bir ileti yazar.
Not
Olay günlüğüne büyük miktarlarda veri yazma olasılığını önlemek için, EventLogTraceListener özelliği tarafından belirtilen isteğe bağlı izleme verilerinin çıkışını TraceOutputOptions vermez.
Oluşturucular
| EventLogTraceListener() |
İzleme dinleyicisi EventLogTraceListener olmadan sınıfının yeni bir örneğini başlatır. |
| EventLogTraceListener(EventLog) |
Belirtilen olay günlüğünü kullanarak sınıfının yeni bir örneğini EventLogTraceListener başlatır. |
| EventLogTraceListener(String) |
Belirtilen kaynağı kullanarak sınıfının yeni bir örneğini EventLogTraceListener başlatır. |
Özellikler
| Attributes |
Uygulama yapılandırma dosyasında tanımlanan özel izleme dinleyicisi özniteliklerini alır. (Devralındığı yer: TraceListener) |
| EventLog |
Yazacak olay günlüğünü 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. (Devralındığı yer: TraceListener) |
| Name |
Bu EventLogTraceListeneröğesinin adını alır veya ayarlar. |
| NeedIndent |
Çıkışın girintili olup olmayacağını 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 olay günlüğü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 . (Devralındığı yer: TraceListener) |
| Flush() |
Türetilmiş bir sınıfta geçersiz kılındığında çıkış arabelleği temizlenir. (Devralındığı yer: TraceListener) |
| 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. (Devralındığı yer: TraceListener) |
| 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 olay günlüğüne yazar. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
İzleme bilgilerini, veri nesnesini ve olay bilgilerini dinleyiciye özel çıkışa yazar. (Devralındığı yer: TraceListener) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
İzleme bilgilerini, bir veri nesneleri dizisini ve olay bilgilerini olay günlüğüne yazar. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
dinleyiciye özgü çıkışa bir dizi veri nesnesi ve olay bilgisi olan izleme bilgilerini yazar. (Devralındığı yer: TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
dinleyiciye özgü çıkışa izleme ve olay bilgileri yazar. (Devralındığı yer: TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
İzleme bilgilerini, bir iletiyi ve olay bilgilerini olay günlüğüne yazar. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
İzleme bilgilerini, bir iletiyi ve olay bilgilerini dinleyiciye özel çıkışa yazar. (Devralındığı yer: TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
İzleme bilgilerini, biçimlendirilmiş bir nesne dizisini ve olay bilgilerini olay günlüğüne yazar. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Dinleyiciye özgü çıkışa, biçimlendirilmiş bir nesne dizisi ve olay bilgileri olan izleme bilgilerini yazar. (Devralındığı yer: TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
İzleme bilgilerini, bir iletiyi, ilgili etkinlik kimliğini ve olay bilgilerini dinleyiciye özel çıktıya yazar. (Devralındığı yer: TraceListener) |
| 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 nesne ToString() yönteminin TraceListener değerini yazar. (Devralındığı yer: TraceListener) |
| Write(String) |
Bu örneğin olay günlüğüne bir ileti 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ı ekler. (Devralındığı yer: TraceListener) |
| WriteLine(Object, String) |
Sınıfı 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) |
Bu örneğin olay günlüğüne bir ileti yazar. |
| WriteLine(String, String) |
Sınıfı uygularken TraceListener oluşturduğunuz dinleyiciye bir kategori adı ve ileti, ardından bir satır sonlandırıcı yazar. (Devralındığı yer: TraceListener) |
Şunlara uygulanır
İş Parçacığı Güvenliği
Bu güvenli iş parçacığı türüdür.
