Gewusst wie: Schreiben in ein Anwendungsereignisprotokoll (Visual Basic)

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 ETW-Ereignisse in .NET Framework.

Tipp

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.

   Tipp

   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" (Visual Basic).

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 (Visual Basic) 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 (Visual Basic)

Referenz

Microsoft.VisualBasic.Logging.Log

WriteEntry

WriteException

Konzepte

Arbeiten mit Anwendungsprotokollen in Visual Basic