Freigeben über


Beispiel für Ereignisprotokoll

Aktualisiert: November 2007

In diesem Beispiel wird dargestellt, wie Ereignisprotokolle erstellt und gelöscht werden und wie Systemereignisprotokolle und Protokolle für benutzerdefinierte Ereignisse gelesen und geschrieben werden.

Visual Basic bietet zwei unterschiedliche Protokolliermechanismen:

  • Die in diesem Beispiel verwendete EventLog-Komponente ermöglicht den Zugriff auf die Ereignisprotokolle des Betriebssystems. Sie können Protokolle hinzufügen und entfernen, Ereignisprotokollquellen hinzufügen und entfernen sowie Meldungen schreiben und löschen.

  • Das My.Application.Log-Objekt bietet auch Zugriff auf einige EventLog-Features. Darüber hinaus enthält My.Application.Log Features, mit deren Hilfe Sie Meldungen in Textdateien schreiben können. Weitere Informationen finden Sie unter Beispiel für die Protokollierung und Protokollieren von Informationen aus der Anwendung.

So erhalten Sie Beispiele und Anweisungen zu ihrer Installation

  • Führen Sie eine oder mehrere der folgenden Aktionen aus:

    • Klicken Sie im Menü Hilfe auf Samplings.

      In der Infodatei befinden sich Informationen zu Beispielen.

    • Gehen Sie zur Website mit Visual Studio 2008-Beispielen. Hier stehen die aktuellsten Versionen der Beispiele bereit.

    • Suchen Sie Beispiele auf dem Computer, auf dem Visual Studio installiert wurde. Standardmäßig werden Beispiele und eine Infodatei unter Laufwerk:\Programme\Microsoft Visual Studio 9.0\Beispiele\lcid installiert. Für die Express-Version von Visual Studio werden alle Beispiele online bereitgestellt.

Weitere Informationen finden Sie unter Suchen von Beispieldateien.

Sicherheitshinweis:

Dieser Beispielcode soll lediglich ein Konzept veranschaulichen. Es wird nur der für das jeweilige Konzept relevante Code dargestellt. Möglicherweise erfüllt dieser nicht die Sicherheitsanforderungen für eine bestimmte Umgebung, und er sollte nicht genau wie dargestellt verwendet werden. Wir empfehlen, Sicherheits- und Fehlerbehandlungscode hinzuzufügen, um Ihre Projekte sicherer und stabiler zu machen. Microsoft stellt diesen Beispielcode "wie besehen" und ohne Garantien zur Verfügung.

So führen Sie dieses Beispiel aus

  • Drücken Sie F5.

    Nicht alle Betriebssysteme unterstützen Ereignisprotokolle. Weitere Informationen finden Sie unter EventLog.

Veranschaulicht

Das Hauptformular, Form1, enthält drei Button-Steuerelemente zum Lesen, Schreiben, Erstellen oder Löschen von Ereignisprotokollen. Mit jedem Steuerelement wird ein neues Formular geöffnet, mit dem spezielle Informationen für den Vorgang gesammelt werden.

Mit dem Formular WriteForm werden der Text, die ID und der Typ eines Ereignisprotokolleintrags erfasst, und der Eintrag wird mithilfe der WriteEntry-Methode in das Anwendungsereignisprotokoll geschrieben.

Mit dem Formular ReadForm wird ein ListBox-Steuerelement mit den Namen der Ereignisprotokolle auf dem Computer gefüllt. Die Liste wird abgerufen, indem die GetEventLogs-Methode aufgerufen und anschließend der Wert der LogDisplayName-Eigenschaft für jedes Protokoll angezeigt wird. Die letzten zehn Einträge des ausgewählten Protokolls werden mit der Entries-Eigenschaft abgerufen und danach in einem RichTextBox-Steuerelement angezeigt.

Mit dem Formular CreateDeleteForm wird die CreateEventSource-Methode und die Delete-Methode aufgerufen. Mit der SourceExists-Methode wird überprüft, ob das Ereignisprotokoll und die Quelle nicht schon vorhanden sind, bevor sie erstellt werden. Mit der Exists-Methode wird überprüft, ob das Ereignisprotokoll vorhanden ist, bevor es gelöscht wird.

Siehe auch

Aufgaben

Beispiel für die Protokollierung

Konzepte

Einführung in die EventLog-Komponente

Protokollieren von Informationen aus der Anwendung

Referenz

EventLog

System.Diagnostics