Beispiel für die Protokollierung

Aktualisiert: November 2007

In diesem Beispiel werden die Verwendung und die Konfiguration des My.Application.Log-Objekts gezeigt.

Visual Basic stellt zwei verschiedene Protokollierungsmechanismen zur Verfügung. My.Application.Log ermöglicht den Zugriff auf die Ereignisprotokolle des Betriebssystems. Außerdem bietet es die Möglichkeit, Meldungen in Textdateien zu schreiben. Die EventLog-Komponente bietet Zugriff auf die Ereignisprotokolle des Betriebssystems. Mit der EventLog-Komponente können Sie Protokolle hinzufügen und löschen, Ereignisprotokollquellen hinzufügen und entfernen sowie Meldungen schreiben und löschen. Beispielcode finden Sie unter Beispiel für Ereignisprotokoll.

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

1. Drücken Sie F5. Im Hauptformular werden die Listener aufgeführt, die für das Beispiel konfiguriert sind.

2. Schreiben Sie eine Meldung in das TextBox-Steuerelement auf dem Formular.

3. Klicken Sie auf die Schaltfläche Write Log Message.

   Die Meldung wird in alle Listener geschrieben.

   1. Die vom XmlWriterTraceListener geschriebene XML-Datei befindet sich in c:\logsamples\SampleLog.xml.

   2. Die vom FileLogTraceListener geschriebene Nur-Text-Datei befindet sich im Verzeichnis "Anwendungsdaten". Wenn Sie das Programm in Visual Studio ausführen, sieht der Pfad ungefähr wie folgt aus: "c:\Dokumente und Einstellungen\[Benutzer]\Anwendungsdaten\Microsoft Corporation\Microsoft Visual Studio\[8.0*]\LogSample.log".

Veranschaulicht

Dieses Beispiel bietet Folgendes:

• Form1   Stellt ein einfaches Formular bereit, das alle für My.Application.Log aktivierten Listener darstellt sowie über Steuerelemente verfügt, mit denen Text in My.Application.Log geschrieben werden kann.

• app.config   Definiert die Konfiguration für My.Application.Log; gibt unter anderem an, an welcher Stelle Meldungen geschrieben werden sollen und welche Meldungen gefiltert werden sollen.

Dieses Beispiel zeigt, wie My.Application.Log zum Schreiben einer Nur-Text-Datei, dem Ereignisprotokoll und einer XML-Datei verwendet werden kann. Sie können problemlos einen benutzerdefinierten TraceListener implementieren, der auch an andere Stellen schreibt, z. B. eine Datenbank oder eine E-Mail-Nachricht.

Jeder Meldung wird der auf dem Formular ausgewählte "Schweregrad" zugewiesen. Wenn der Listener die Meldung empfängt, verwirft er sie unter Umständen auf der Grundlage seiner Filterebene. Die EventLogTraceListener-Komponente ist beispielsweise nur für das Schreiben von Fehlermeldungen konfiguriert. Folglich werden alle Meldungen mit dem Schweregrad "Information" oder "Warnung" in die XML- und die Nur-Text-Datei und nicht in das EventLog geschrieben.

Bearbeiten Sie die Datei app.config des Projekts, um das Verhalten des Beispiels zu ändern. Kommentare in der Datei dienen als Leitfaden für Änderungen.

Sie können My.Application.Log und das Anwendungsmodell verwenden, um Ausnahmen beim Starten und beim Herunterfahren sowie nicht behandelte Ausnahmen zu protokollieren. Wenn Sie sich den Code für dieses Beispiel ansehen möchten, doppelklicken Sie im Projektmappen-Explorer auf Eigenes Projekt. Klicken Sie im Bereich Anwendung auf die Schaltfläche Code anzeigen.

Siehe auch

Aufgaben

Beispiel für Ereignisprotokoll

Konzepte

Arbeiten mit Anwendungsprotokollen in Visual Basic