Gewusst wie: Konfigurieren von Instanzen von EventLog-Komponenten

Aktualisiert: November 2007

Um eine Instanz der EventLog-Komponente zu konfigurieren, arbeiten Sie mit drei Haupteigenschaften:

• Die Log-Eigenschaft gibt das Protokoll an, mit dem Sie interagieren möchten.

• Die MachineName-Eigenschaft gibt den Computer an, auf dem sich das betreffende Protokoll befindet.

• Die Source-Eigenschaft gibt die Quellzeichenfolge an, über die die Komponente identifiziert wird, wenn sie Einträge in ein Protokoll schreibt.

Wie Sie die Instanz der EventLog-Komponente konfigurieren, hängt von ihrer Verwendungsweise ab:

• Es gibt zwei Möglichkeiten, Einträge in ein Protokoll zu schreiben. Entweder müssen Sie eine Quelle mithilfe der CreateEventSource-Methode registrieren und die Source-Eigenschaft der EventLog-Komponente auf dieselbe Quelle festlegen, oder Sie müssen die Eigenschaften MachineName, Log und Source für die Komponente festlegen.

  Hinweis:
  Sie können die Log-Eigenschaft direkt in der Komponente oder aber im Code festlegen, durch den die Komponente als Ereignisquelle registriert wird. Nachdem die Komponente als Quelle registriert wurde, befindet sich in der Registrierung des Servers automatisch eine Verbindung, über die die Komponente mit einem bestimmten Protokoll verknüpft wird.

• Wenn Sie Protokolleinträge lesen oder ein Protokoll überwachen möchten, müssen Sie die MachineName-Eigenschaft und die Log-Eigenschaft so festlegen, dass das überwachte Protokoll darin angegeben ist. In diesem Fall muss die Source-Eigenschaft nicht festgelegt werden.

• Wenn die Komponente Benachrichtigungen von EntryWritten-Ereignissen empfangen können soll, müssen Sie EnableRaisingEvents auf true festlegen. Weitere Informationen hierzu finden Sie unter Gewusst wie: Behandeln des EntryWritten-Ereignisses.

  Im folgenden Beispiel erfahren Sie, wie Sie die Komponente so konfigurieren, dass Einträge in das Anwendungsprotokoll geschrieben werden können. Die Quelle wurde hier noch nicht für das Protokoll registriert. Folglich müssen Sie die Quellzeichenfolge, das Protokoll und den Computernamen angeben. Sie müssen die CreateEventSource-Methode nicht explizit aufrufen, da die Quelle durch den WriteEntry-Aufruf für das Protokoll registriert wird, falls sie noch nicht registriert wurde.

  Dim EventLog1 As New EventLog("Application", "myserver", "newsource")
  EventLog1.WriteEntry("Test")
  

       System.Diagnostics.EventLog EventLog1 = new
             System.Diagnostics.EventLog("Application", "myserver", "newsource");
          EventLog1.WriteEntry("Test");
  

  Falls die Quelle bereits registriert wurde, legen Sie einfach die Source-Eigenschaft fest und schreiben dann den Eintrag. Folgender Code zeigt, wie Sie einen Eintrag unter Verwendung einer bereits registrierten Quelle in ein Protokoll schreiben.

  If Not EventLog.SourceExists("ExistingSourceString") Then
      EventLog.CreateEventSource("ExistingSourceString", "Application")
  End If
  Dim EventLog1 As New EventLog()
  EventLog1.Source = "ExistingSourceString"
  EventLog1.WriteEntry("TestEntry2")
  

       if (!System.Diagnostics.EventLog.SourceExists("ExistingSourceString"))
              System.Diagnostics.EventLog.CreateEventSource(
                 "ExistingSourceString", "Application");
  
          System.Diagnostics.EventLog EventLog1 =
             new System.Diagnostics.EventLog();
          EventLog1.Source = "ExistingSourceString";
          EventLog1.WriteEntry("TestEntry2");
  

  Hinweis:
  Wenn Sie die MachineName-Eigenschaft, wie in diesen Beispielen gezeigt, nicht festlegen, wird der lokale Computer als Speicherort angenommen.

  Weitere Informationen über diese Eigenschaften finden Sie unter den Ausführungen zu Ereignisprotokollverweise.

  Die aus einem Ereignisprotokoll abgerufenen Einträge sind nach mehreren Eigenschaften klassifiziert. Informationen über diese Eigenschaften finden Sie unter den Ausführungen zu EventLog.

So konfigurieren Sie eine Instanz der EventLog-Komponente

1. Erstellen Sie eine Instanz der EventLog-Komponente. Weitere Informationen hierzu finden Sie unter Gewusst wie: Erstellen von Instanzen von EventLog-Komponenten.

2. Legen Sie eine geeignete Kombination der Eigenschaften Log, MachineName und Source fest:

   Aktion	Vorgehensweise
   Ereignisprotokolle lesen oder überwachen	Legen Sie Log auf MachineName fest.
   Einträge mithilfe einer neuen Source-Zeichenfolge in ein Protokoll schreiben	Legen Sie Source, Log und MachineName fest.
   Einträge für ein vorhandenes Source-Objekt in ein Protokoll schreiben	Legen Sie als Source-Eigenschaft eine vorhandene Quelle fest. Die anderen Eigenschaften werden automatisch definiert.

3. Damit die Komponenteninstanz Benachrichtigungen von dem EntryWritten-Ereignis empfangen kann, legen Sie die EnableRaisingEvents-Eigenschaft auf true fest.

Siehe auch

Aufgaben

Gewusst wie: Erstellen von Instanzen von EventLog-Komponenten

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

Gewusst wie: Schreiben von Einträgen in Ereignisprotokolle

Konzepte

Ereignisprotokollverweise