Code-Beispiel
Ein Beispiel zum Einsatz der Klasse System.Diagnostics.EventLog aus der .NET-Klassenbibliothek.
Autor: Dr. Holger Schwichtenberg
Beschreibung
Die Klasse EventLog bietet auch ein Ereignis EventWritten(), das immer dann ausgelöst wird, wenn in das Ereignisprotokoll, das das EventLog-Objekt repräsentiert, ein neuer Eintrag geschrieben wird. Die Ereignisbehandlungsroutine bekommt über ein Objekt des Typs EntryWrittenEventArgs Informationen über den neuen Eintrag.
Beispiel
Das Beispiel zeigt die Überwachung des Protokolls "DOTNET". Zwei neue Einträge werden mit der Routine EventLog_Write() aus dem vorherigen Kapitel erzeugt, nachdem mit AddHandler das Ereignis gebunden und mit Thread.Sleep() eine kurze Pause erzeugt wurde.
Programmcodebeispiele Visual Basic .NET (VB.NET)
' ============================
' .NET-Code-Beispiel in Visual Basic .NET
' Überwachung eines Ereignisprotokolls
' (C) Holger@Schwichtenberg.de
' ============================
Sub EventLog_Watcher()
Dim Log As EventLog
' --- Instanziierung und Konfiguration
Log = New EventLog()
Log.Log = "DOTNET"
Log.MachineName = "Mars"
' --- Verbindung der Ereignisbehandlungsroutine
AddHandler Log.EntryWritten, AddressOf EventLog_NeuerEintrag
' --- Starten der Überwachung
Log.EnableRaisingEvents = True
Thread.Sleep(5000)
EventLog_Write()
EventLog_Write()
' --- Warten auf Benutzeraktion
MsgBox("Klicken Sie hier, um die Überwachung zu beenden!", , "Überwachung")
End Sub
' ### Ereignisbehandlungsroutine für Event-Log-Überwachung
Sub EventLog_NeuerEintrag(ByVal source As Object, ByVal Ereignis As EntryWrittenEventArgs)
Dim eintrag As EventLogEntry
eintrag = Ereignis.Entry
out(eintrag.EntryType & ":" & _
eintrag.EventID & ":" & _
eintrag.Category & ":" & _
eintrag.Message & ":" & _
eintrag.Source & ":" & _
eintrag.TimeGenerated & ":" & _
eintrag.TimeWritten & ":" & _
eintrag.UserName)
End Sub
Programmcodebeispiele CSharp (C#)
using System;
using System.IO;
using System.Threading;
using System.Diagnostics;
using System.Windows.Forms;
using FCL_Buch;
namespace FCLBuch._SystemDiagnostics {
public class Samples_EventLog {
public void EventLog_Watcher() {
// Überwachung eines Ereignisprotokolls
// Instanziierung und Konfiguration
EventLog log = new EventLog();
log.Log = "DOTNET";
log.MachineName = "Dagobar";
// Verbindung der Ereignisbehandlungsroutine
log.EntryWritten += new EntryWrittenEventHandler( this.EventLog_NeuerEintrag );
// Starten der Überwachung
log.EnableRaisingEvents = true;
Thread.Sleep(5000);
EventLog_Write();
EventLog_Write();
// Warten auf Benutzeraktion
MessageBox.Show( "Klicken Sie hier, um die Überwachung zu beenden!", "Überwachung" );
}
}
}
Hinweise
Ausgaben werden in den Beispielen durch Hilfsroutinen wie out() und
PrintOut() erzeugt. Diese sind hier nicht angegeben, da deren Implementierung
von der jeweiligen Umgebung abhängt. Für Konsolenanwendungen können hier z.B.
Console.WriteLine() einsetzen.
Querverweise
Liste aller Codebeispiele
Definition '.NET Framework Class Library'
Verfügbarkeit der Klasse 'System.Diagnostics.EventLog'
Übersicht über den FCL-Namensraum 'System.Diagnostics'
.NET & Visual Studio Community Portal