EventLogTraceListener Kelas

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.EventLog.dll

Paket:

System.Diagnostics.EventLog v8.0.0

Sumber:

EventLogTraceListener.cs

Menyediakan pendengar sederhana yang mengarahkan output pelacakan atau penelusuran kesalahan ke EventLog.

public ref class EventLogTraceListener sealed : System::Diagnostics::TraceListener

public sealed class EventLogTraceListener : System.Diagnostics.TraceListener

type EventLogTraceListener = class
    inherit TraceListener

Public NotInheritable Class EventLogTraceListener
Inherits TraceListener

Warisan

Object

MarshalByRefObject

TraceListener

EventLogTraceListener

Contoh

Contoh berikut membuat listener pelacakan yang mengirim output ke log peristiwa. Pertama, kode membuat baru EventLogTraceListener yang menggunakan sumber myEventLogSource. Selanjutnya, myTraceListener ditambahkan ke Trace.Listeners koleksi. Terakhir, contoh mengirimkan baris output ke Listeners objek .

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

Keterangan

Instans ini EventLogTraceListener dapat ditambahkan ke Debug.Listenerskoleksi , , Trace.Listenersatau TraceSource.Listeners untuk mengirim output dari pelacakan atau penelusuran kesalahan ke EventLog. Anda dapat menambahkan instans dalam kode Anda atau, untuk aplikasi .NET Framework, menentukannya dalam file konfigurasi aplikasi.

Untuk menambahkan EventLogTraceListener menggunakan file konfigurasi aplikasi .NET Framework, edit file yang sesuai dengan nama aplikasi Anda. Dalam file ini, sisipkan elemen untuk tipe System.Diagnostics.EventLogTraceListener . Contoh berikut menambahkan objek bernama EventLogTraceListenermyListener ke Trace.Listeners koleksi. Parameter initializeData menentukan nama sumber log peristiwa yang akan diteruskan ke EventLogTraceListener(String) konstruktor.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener"  
          type="System.Diagnostics.EventLogTraceListener"  
          initializeData="TraceListenerLog" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Catatan

Source Jika untuk log peristiwa yang terkait dengan EventLogTraceListener instans tidak ada, sumber peristiwa baru dibuat. Untuk membuat sumber kejadian di Windows Vista, Windows XP Professional, atau Windows Server 2003, Anda harus memiliki hak administratif.

Alasan untuk persyaratan ini adalah bahwa semua log peristiwa, termasuk keamanan, harus dicari untuk menentukan apakah sumber peristiwa unik. Di Windows Vista, pengguna tidak memiliki izin untuk mengakses log keamanan; oleh karena itu, dilemparkan SecurityException .

Di Windows Vista, Kontrol Akun Pengguna (UAC) menentukan hak istimewa pengguna. Jika Anda adalah anggota grup Administrator Bawaan, Anda diberi dua token akses run-time: token akses pengguna standar dan token akses administrator. Secara default, Anda berada dalam peran pengguna standar. Untuk menjalankan kode yang mengakses log keamanan, Anda harus terlebih dahulu meningkatkan hak istimewa Anda dari pengguna standar ke administrator. Anda dapat melakukan ini saat memulai aplikasi dengan mengeklik kanan ikon aplikasi dan menunjukkan bahwa Anda ingin menjalankan sebagai administrator.

Kelas menyediakan EventLog properti untuk mendapatkan atau mengatur log peristiwa yang menerima output pelacakan atau penelusuran kesalahan, dan Name properti untuk menyimpan nama EventLogTraceListener.

Metode Close menutup log peristiwa sehingga tidak lagi menerima output pelacakan atau penelusuran kesalahan. Metode Write dan WriteLine menulis pesan ke log peristiwa.

Catatan

Untuk menghindari kemungkinan penulisan data dalam jumlah besar ke log peristiwa, EventLogTraceListener tidak menghasilkan data pelacakan opsional yang ditentukan oleh TraceOutputOptions properti .

Konstruktor

EventLogTraceListener()	Menginisialisasi instans EventLogTraceListener baru kelas tanpa pendengar jejak.
EventLogTraceListener(EventLog)	Menginisialisasi instans EventLogTraceListener baru kelas menggunakan log peristiwa yang ditentukan.
EventLogTraceListener(String)	Menginisialisasi instans EventLogTraceListener baru kelas menggunakan sumber yang ditentukan.

Properti

Attributes	Mendapatkan atribut listener pelacakan kustom yang ditentukan dalam file konfigurasi aplikasi. (Diperoleh dari TraceListener)
EventLog	Mendapatkan atau mengatur log peristiwa untuk ditulis.
Filter	Mendapatkan atau mengatur filter pelacakan untuk pendengar pelacakan. (Diperoleh dari TraceListener)
IndentLevel	Mendapatkan atau mengatur tingkat inden. (Diperoleh dari TraceListener)
IndentSize	Mendapatkan atau mengatur jumlah spasi dalam inden. (Diperoleh dari TraceListener)
IsThreadSafe	Mendapatkan nilai yang menunjukkan apakah pendengar jejak aman untuk utas. (Diperoleh dari TraceListener)
Name	Mendapatkan atau mengatur nama ini EventLogTraceListener.
NeedIndent	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan mengindentasi output. (Diperoleh dari TraceListener)
TraceOutputOptions	Mendapatkan atau mengatur opsi output jejak. (Diperoleh dari TraceListener)

Metode

Close()	Menutup log peristiwa sehingga tidak lagi menerima output pelacakan atau penelusuran kesalahan.
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang TraceListenerdigunakan oleh . (Diperoleh dari TraceListener)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang TraceListener digunakan oleh dan secara opsional merilis sumber daya terkelola. (Diperoleh dari TraceListener)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Fail(String)	Memancarkan pesan kesalahan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas. (Diperoleh dari TraceListener)
Fail(String, String)	Memancarkan pesan kesalahan dan pesan kesalahan terperinci ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas. (Diperoleh dari TraceListener)
Flush()	Ketika ditimpa di kelas turunan, siram buffer output. (Diperoleh dari TraceListener)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetSupportedAttributes()	Mendapatkan atribut kustom yang didukung oleh pendengar pelacakan. (Diperoleh dari TraceListener)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Menulis informasi pelacakan, objek data, dan informasi peristiwa ke log peristiwa.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Menulis informasi pelacakan, array objek data, dan informasi peristiwa ke log peristiwa.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Menulis informasi pelacakan dan peristiwa ke output spesifik pendengar. (Diperoleh dari TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Menulis informasi pelacakan, pesan, dan informasi peristiwa ke log peristiwa.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Menulis informasi pelacakan, array objek yang diformat, dan informasi peristiwa ke log peristiwa.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Menulis informasi pelacakan, pesan, identitas aktivitas terkait, dan informasi peristiwa ke output spesifik pendengar. (Diperoleh dari TraceListener)
Write(Object)	Menulis nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas. (Diperoleh dari TraceListener)
Write(Object, String)	Menulis nama kategori dan nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas. (Diperoleh dari TraceListener)
Write(String)	Menulis pesan ke log peristiwa untuk instans ini.
Write(String, String)	Menulis nama kategori dan pesan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas. (Diperoleh dari TraceListener)
WriteIndent()	Menulis inden ke pendengar yang Anda buat saat mengimplementasikan kelas ini, dan mengatur ulang NeedIndent properti ke false. (Diperoleh dari TraceListener)
WriteLine(Object)	Menulis nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti dengan terminator baris. (Diperoleh dari TraceListener)
WriteLine(Object, String)	Menulis nama kategori dan nilai metode objek ToString() ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti dengan terminator baris. (Diperoleh dari TraceListener)
WriteLine(String)	Menulis pesan ke log peristiwa untuk instans ini.
WriteLine(String, String)	Menulis nama kategori dan pesan ke pendengar yang Anda buat saat mengimplementasikan TraceListener kelas, diikuti dengan terminator baris. (Diperoleh dari TraceListener)

Keamanan Thread

Jenis ini aman untuk utas.

Lihat juga

• TraceListener
• DefaultTraceListener
• TextWriterTraceListener
• EventLog
• Stream
• TextWriter
• Debug
• Trace