Gewusst wie: Schreiben in ein Anwendungsereignisprotokoll

Aktualisiert: November 2007

Sie können das My.Application.Log-Objekt und das My.Log-Objekt verwenden, um Informationen über in der Anwendung auftretende Ereignisse zu protokollieren. In diesem Beispiel wird veranschaulicht, wie Sie eine Ereignisprotokollüberwachung so konfigurieren, dass My.Application.Log Ablaufverfolgungsdaten in das Anwendungsereignisprotokoll schreibt.

Sie können keine Daten in das Sicherheitsprotokoll schreiben. Zum Schreiben von Daten in das Systemprotokoll müssen Sie Mitglied des LocalSystem- oder Administratorkontos sein.

Zum Anzeigen eines Ereignisprotokolls können Sie den Server-Explorer oder die Ereignisanzeige von Windows verwenden. Weitere Informationen finden Sie unter Gewusst wie: Arbeiten mit Ereignisprotokollen im Server-Explorer oder unter Gewusst wie: Starten des Ereignis-Viewers aus dem Server-Explorer.

Hinweis:
Unter Windows 95, Windows 98 bzw. Windows Millennium Edition werden Ereignisprotokolle nicht unterstützt.

So fügen Sie die Ereignisprotokollüberwachung hinzu und konfigurieren diese

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf app.config, und wählen Sie Öffnen.

   oder

   Wenn keine app.config-Datei vorhanden ist:

   1. Klicken Sie im Menü Projekt auf Neues Element hinzufügen.

   2. Klicken Sie im Dialogfeld Neues Element hinzufügen auf Anwendungskonfigurationsdatei.

   3. Klicken Sie auf Hinzufügen.

2. Suchen Sie den <listeners>-Abschnitt in der Anwendungskonfigurationsdatei.

   Der <listeners>-Abschnitt befindet sich im <source>-Abschnitt mit dem name-Attribut "DefaultSource". Dieser befindet sich im <system.diagnostics>-Abschnitt im <configuration>-Abschnitt auf der obersten Ebene.

3. Fügen Sie diesem <listeners>-Abschnitt dieses Element hinzu:

   <add name="EventLog"/>
   

4. Suchen Sie den <sharedListeners>-Abschnitt im <system.diagnostics>-Abschnitt im <configuration>-Abschnitt auf der obersten Ebene.

5. Fügen Sie diesem <sharedListeners>-Abschnitt dieses Element hinzu:

   <add name="EventLog"
       type="System.Diagnostics.EventLogTraceListener, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
        initializeData="APPLICATION_NAME"/>
   

   Ersetzen Sie APPLICATION_NAME durch den Namen der Anwendung.

   Hinweis:
   In der Regel schreibt eine Anwendung nur Fehler ins Ereignisprotokoll. Informationen zum Filtern von Protokollausgaben finden Sie unter Exemplarische Vorgehensweise: Filterung der Ausgaben von "My.Application.Log".

So schreiben Sie Ereignisinformationen ins Ereignisprotokoll

• Verwenden Sie die My.Application.Log.WriteEntry-Methode oder die My.Application.Log.WriteException-Methode, um Informationen ins Ereignisprotokoll zu schreiben. Weitere Informationen finden Sie unter Gewusst wie: Schreiben von Protokollmeldungen und unter Gewusst wie: Protokollieren von Ausnahmen in Visual Basic.

  Wenn Sie die Ereignisprotokollüberwachung für eine Assembly konfigurieren, empfängt diese alle Meldungen, die My.Applcation.Log schreibt, von dieser Assembly.

Siehe auch

Aufgaben

Gewusst wie: Protokollieren von Ausnahmen in Visual Basic

Exemplarische Vorgehensweise: Bestimmen, wohin "My.Application.Log" Informationen schreibt

Konzepte

Arbeiten mit Anwendungsprotokollen in Visual Basic

Referenz

My.Application.Log-Objekt

My.Log-Objekt

WriteEntry-Methode ("My.Application.Log" und "My.Log")

WriteException-Methode ("My.Application.Log" und "My.Log")