EventLog-Programmierarchitektur
Aktualisiert: November 2007
Die EventLog-Komponente verwendet diese Teile der .NET Framework-Namespaces:
EventLog-Namespace
.gif)
Wenn Sie in Visual Studio einer Anwendung eine Instanz der EventLog-Komponente hinzufügen, erstellt das System automatisch die Verweise und Importanweisungen, die für den Zugriff auf den Namespace und die Klassen erforderlich sind. Wenn Sie die EventLog-Komponenten jedoch im Code oder in Microsoft .NET Framework erstellen, müssen Sie möglicherweise einen Verweis auf System.Diagnostics erstellen und Ihrem Projekt eine Anweisung zum Importieren derselben Bibliothek hinzufügen.
Anweisungen zum Hinzufügen oder Entfernen von Projektverweisen finden Sie unter Gewusst wie: Hinzufügen oder Entfernen von Verweisen in Visual Studio (Visual Basic).
Grundlegende Programmierelemente in der EventLog-Klasse
Die EventLog-Komponente löst ein Ereignis mit dem Namen EntryWritten aus, sobald ein Eintrag in das überwachte Protokoll geschrieben wird. Sie können für dieses Ereignis einen Handler definieren. Zusätzlich stehen Ihnen die folgenden Methoden zur Verfügung, um mit einer Instanz der EventLog-Komponente zu interagieren:
Mit der Exists-Methode können Sie bestimmen, ob ein bestimmtes Ereignisprotokoll vorhanden ist.
Mit der CreateEventSource-Methode können Sie eine Zeichenfolge definieren, die eine Beziehung zwischen einer Ereignisquelle und einem Protokoll herstellt. Diese Verbindung wird mit der DeleteEventSource-Methode wieder gelöst. Darüber hinaus können Sie mit dieser Methode neue benutzerdefinierte Ereignisprotokolle erstellen. Geben Sie für das Protokoll, in dem Sie die Quelle erstellen möchten, einfach einen neuen Protokollnamen ein. Das Protokoll wird daraufhin automatisch vom System erstellt.
.gif "Hinweis")
Hinweis:Sie können für die Source-Eigenschaft eine beliebige Zeichenfolge festlegen; sie muss nicht mit dem Namen der Anwendung übereinstimmen. Eine einzelne Anwendung kann mehrere Komponenten enthalten, die jeweils unterschiedliche Quellzeichenfolgen verwenden, um sich gegenüber den Ereignisprotokollen zu identifizieren.
Mit der WriteEntry-Methode können Sie Ereignisinformationen in ein beliebiges Ereignisprotokoll schreiben, auf das Sie Zugriff haben. Durch die WriteEntry-Methode wird die Komponente oder Anwendung automatisch als gültige Quelle registriert, falls sie noch nicht für das angegebene Protokoll registriert wurde.
Mit der SourceExists-Methode können Sie feststellen, ob eine bestimmte Quelle bereits registriert wurde. Da die SourceExists-Methode einen Laufzeitfehler ausgibt, falls die Quelle auf dem jeweiligen Computer bereits registriert ist, ist diese Methode hilfreich, wenn Sie versuchen, eine neue Quelle auf dem Computer zu erstellen.
Mit der GetEventLogs-Methode können Sie eine Liste aller Ereignisprotokolle auf einem bestimmten Computer abrufen.
Mit der Delete-Methode können Sie ein Ereignisprotokoll vollständig löschen. Diese Methode ist mit Vorsicht zu verwenden, da durch das Löschen eines Protokolls auch alle darin registrierten Quellen gelöscht werden.