Gewusst wie: Hinzufügen der Anwendung als Quelle für Ereignisprotokolleinträge

Artikel
09/02/2008

Aktualisiert: November 2007

Damit die Komponente Einträge in ein Ereignisprotokoll schreiben kann, muss sie als gültige Ereignisquelle für das Ereignisprotokoll registriert werden. Zu diesem Zweck verwenden Sie die CreateEventSource-Methode und geben eine Zeichenfolge an, durch die die Komponente gegenüber dem Ereignisprotokoll eindeutig identifiziert wird. Wenn Sie einen Protokolleintrag schreiben, sucht das System anhand der angegebenen Quelle das Protokoll, dem der Eintrag hinzugefügt werden soll. Die Instanz der EventLog-Komponente kann jeweils nur in ein Protokoll schreiben.

Hinweis:
Wenn Sie einen Eintrag schreiben, ohne dass die Komponente zuvor als gültige Quelle registriert wurde, wird die Quelle vom System automatisch für das Ereignisprotokoll registriert. Dabei wird der Wert der Source-Eigenschaft als Quellzeichenfolge verwendet. Im Allgemeinen erstellen Sie die neue Ereignisquelle während der Installation der Anwendung. Dies gibt dem Betriebssystem Gelegenheit, die Liste der registrierten Ereignisquellen und deren Konfiguration zu aktualisieren. Wenn das Betriebssystem die Liste der Ereignisquellen nicht aktualisiert hat und Sie versuchen, ein Ereignis mit der neuen Quelle zu schreiben, schlägt der Schreibvorgang fehl. Wenn die Quelle nicht während der Installation erstellt werden kann, versuchen Sie, die Quelle deutlich vor dem ersten Schreibvorgang zu erstellen, möglicherweise bei der Anwendungsinitialisierung. Wenn Sie diesen Ansatz wählen, stellen Sie sicher, dass der Initialisierungscode mit Administratorrechten auf dem Computer ausgeführt wird. Diese Rechte sind für das Erstellen von neuen Ereignisquellen erforderlich.

Wenn Sie einen Eintrag schreiben, ohne dass die Komponente zuvor als gültige Quelle registriert wurde, wird die Quelle vom System automatisch für das Ereignisprotokoll registriert. Dabei wird der Wert der Source-Eigenschaft als Quellzeichenfolge verwendet. Im Allgemeinen erstellen Sie die neue Ereignisquelle während der Installation der Anwendung. Dies gibt dem Betriebssystem Gelegenheit, die Liste der registrierten Ereignisquellen und deren Konfiguration zu aktualisieren. Wenn das Betriebssystem die Liste der Ereignisquellen nicht aktualisiert hat und Sie versuchen, ein Ereignis mit der neuen Quelle zu schreiben, schlägt der Schreibvorgang fehl. Wenn die Quelle nicht während der Installation erstellt werden kann, versuchen Sie, die Quelle deutlich vor dem ersten Schreibvorgang zu erstellen, möglicherweise bei der Anwendungsinitialisierung. Wenn Sie diesen Ansatz wählen, stellen Sie sicher, dass der Initialisierungscode mit Administratorrechten auf dem Computer ausgeführt wird. Diese Rechte sind für das Erstellen von neuen Ereignisquellen erforderlich.

Wenn Sie den Namen eines Protokolls angeben, das beim Ausführen der CreateEventSource-Methode nicht gefunden wird, erstellt das System unter diesem Namen ein neues, benutzerdefiniertes Ereignisprotokoll, sobald erstmalig ein Eintrag in das Protokoll geschrieben wird. Weitere Informationen hierzu finden Sie unter Gewusst wie: Erstellen und Entfernen benutzerdefinierter Ereignisprotokolle.

Sie können die Ereignisquelle mit lokalisierten Ressourcen für die Ereigniskategorie und die Meldungszeichenfolgen registrieren. Die Anwendung kann Ereignisprotokolleinträge mit Ressourcenbezeichnern schreiben, anstatt die eigentlichen Zeichenfolgenwerte anzugeben. Weitere Informationen über das Konfigurieren der Quelle mit Ressourcendateien finden Sie unter der EventLogInstaller-Klasse und der EventSourceCreationData-Klasse.

So definieren Sie die Komponente als Ereignisquelle

Um Einträge auf dem lokalen Computer zu erstellen, rufen Sie die CreateEventSource-Methode auf und geben die Quellzeichenfolge und den Protokollnamen als Parameter an.

Hinweis:

Wenn Sie NULL (" ") als Protokollnamen angeben, wird automatisch Application verwendet.

Im folgenden Beispiel wird veranschaulicht, wie Sie die Komponente MyApp1 als Quelle für das Anwendungsprotokoll registrieren. In diesem Codebeispiel wird vorausgesetzt, dass eine Imports-Anweisung oder eine using-Anweisung für den System.Diagnostics-Namespace vorhanden ist:
```
EventLog.CreateEventSource("MyApp1", "Application")
```
```
     System.Diagnostics.EventLog.CreateEventSource("MyApp1", "Application");
```
Tipp:

Um eine Ereignisquelle auf einem Remotecomputer zu erstellen, verwenden Sie EventSourceCreationData. Im Folgenden ein Codebeispiel:
```
Dim creationData As New EventSourceCreationData("ApplicationName", "Application")
creationData.MachineName = "ServerName"
EventLog.CreateEventSource(creationData)
```
```
     System.Diagnostics.EventSourceCreationData creationData = new
            System.Diagnostics.EventSourceCreationData("ApplicationName", "Application");
        creationData.MachineName = "ServerName";
        EventLog.CreateEventSource(creationData);
```

Hinweis:
Wenn Sie NULL (" ") als Protokollnamen angeben, wird automatisch Application verwendet.

Tipp:
Um eine Ereignisquelle auf einem Remotecomputer zu erstellen, verwenden Sie EventSourceCreationData. Im Folgenden ein Codebeispiel:

Siehe auch

Freigeben über

Gewusst wie: Hinzufügen der Anwendung als Quelle für Ereignisprotokolleinträge

So definieren Sie die Komponente als Ereignisquelle

Siehe auch

Aufgaben

Konzepte

Referenz

Zusätzliche Ressourcen