Exemplarische Vorgehensweise: Bestimmen, wohin "My.Application.Log" Informationen schreibt (Visual Basic)

Das My.Application.Log-Objekt kann Informationen in mehrere Protokolllistener schreiben.Die Protokollüberwachungen werden in der Konfigurationsdatei des Computers konfiguriert und können in der Konfigurationsdatei einer Anwendung überschrieben werden.In diesem Thema werden die Standardeinstellungen und das Festlegen der entsprechenden Einstellungen für eine Anwendung beschrieben.

Weitere Informationen über die Speicherorte für die Standardausgabefinden Sie unter Arbeiten mit Anwendungsprotokollen in Visual Basic.

So bestimmen Sie die Listener für My.Application.Log

1. Suchen Sie die Konfigurationsdatei der Assembly.Beim Entwickeln einer Assembly können Sie in Visual Studio im Projektmappen-Explorer auf "app.config" zugreifen.Andernfalls entspricht der Name der Konfigurationsdatei dem Namen der Assembly mit der angefügten Zeichenfolge ".config", und die Datei befindet sich in demselben Verzeichnis wie die Assembly.

   Hinweis
   Nicht jede Assembly verfügt über eine Konfigurationsdatei.

   Die Konfigurationsdatei ist eine XML-Datei.

2. Suchen Sie im <source>-Abschnitt mit dem name-Attribut "DefaultSource" (innerhalb des <sources>-Abschnitts) den <listeners>-Abschnitt.Der <sources>-Abschnitt befindet sich im <system.diagnostics>-Abschnitt (innerhalb des <configuration>-Abschnitts auf der obersten Ebene).

   Wenn diese Abschnitte nicht vorhanden sind, können die My.Application.Log-Protokollüberwachungen in der Konfigurationsdatei des Computers konfiguriert werden.In den folgenden Schritten wird erläutert, wie Sie bestimmen können, welche Elemente in der Computerkonfigurationsdatei definiert werden:

   1. Suchen Sie die Datei machine.config für den Computer.In der Regel befindet sie sich im Verzeichnis SystemRoot\Microsoft.NET\Framework\frameworkVersion\CONFIG, wobei SystemRoot das Betriebssystemverzeichnis und frameworkVersion die Version von .NET Framework ist.

      Die Einstellungen in machine.config können in der Konfigurationsdatei einer Anwendung überschrieben werden.

      Wenn die unten aufgeführten optionalen Elemente nicht vorhanden sind, können Sie diese erstellen.

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

      Wenn diese Abschnitte nicht vorhanden sind, verfügt My.Application.Log nur über die Standardprotokollüberwachungen.

3. Suchen Sie die <add>-Elemente im <listeners>-Abschnitt.

   Mit diesen werden der My.Application.Log-Quelle die benannten Protokollüberwachungen hinzugefügt.

4. Suchen Sie die <add>-Elemente mit den Namen der Protokollüberwachungen im <sharedListeners>-Abschnitt. Dieser befindet sich im <system.diagnostics>-Abschnitt im <configuration>-Abschnitt auf der obersten Ebene.

5. Bei vielen Typen von freigegebenen Listenern umfassen die Initialisierungsdaten eine Beschreibung des Ausgabeziels des Listeners:

   • Ein Microsoft.VisualBasic.Logging.FileLogTraceListener-Listener schreibt in ein Dateiprotokoll, wie in der Einführung beschrieben.

   • Ein System.Diagnostics.EventLogTraceListener-Listener schreibt Informationen in das mit dem initializeData-Parameter angegebene Ereignisprotokoll auf dem Computer.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.

   • Der System.Diagnostics.DelimitedListTraceListener-Listener und der System.Diagnostics.XmlWriterTraceListener-Listener schreiben in die Datei, die im initializeData-Parameter angegeben wurde.

   • Ein System.Diagnostics.ConsoleTraceListener-Listener schreibt in die Befehlszeilenkonsole.

   • Informationen zu den Ausgabezielen für andere Typen von Protokollüberwachungen finden Sie in der Dokumentation für den jeweiligen Typ.

Siehe auch

Aufgaben

Gewusst wie: Protokollieren von Ausnahmen in Visual Basic

Gewusst wie: Schreiben von Protokollmeldungen (Visual Basic)

Exemplarische Vorgehensweise: Ändern des Orts, in den "My.Application.Log" Informationen schreibt (Visual Basic)

Problembehandlung: Protokollüberwachungen (Visual Basic)

Referenz

Microsoft.VisualBasic.Logging.Log

DefaultTraceListener

EventLogTraceListener

DelimitedListTraceListener

XmlWriterTraceListener

ConsoleTraceListener

System.Diagnostics

Konzepte

Arbeiten mit Anwendungsprotokollen in Visual Basic

Weitere Ressourcen

ETW-Ereignisse in .NET Framework