Gewusst wie: Schreiben in ein Anwendungsereignisprotokoll (Visual Basic)How to: Write to an Application Event Log (Visual Basic)

Sie können die Objekte My.Application.Log und My.Log verwenden, um Informationen über Ereignisse zu erfassen, die in Ihrer Anwendung auftreten.You can use the My.Application.Log and My.Log objects to write information about events that occur in your application. Dieses Beispiel veranschaulicht, wie ein Ereignisprotokolllistener konfiguriert wird, damit My.Application.Log Ablaufverfolgungsinformationen in das Anwendungsereignisprotokoll schreibt.This example shows how to configure an event log listener so My.Application.Log writes tracing information to the Application event log.

In das Sicherheitsprotokoll kann nicht geschrieben werden.You cannot write to the Security log. Um in das Systemprotokoll zu schreiben, müssen Sie Mitglied des Kontos "LocalSystem" oder "Administrator" sein.In order to write to the System log, you must be a member of the LocalSystem or Administrator account.

Zum Anzeigen von Ereignisprotokollen können Sie den Server-Explorer oder die Windows-Ereignisanzeigeverwenden.To view an event log, you can use Server Explorer or Windows Event Viewer. Weitere Informationen finden Sie unter ETW Events in the .NET Framework.For more information, see ETW Events in the .NET Framework.

Hinweis

Ereignisprotokolle werden unter Windows 95, Windows 98 bzw. Windows Millennium Edition (ME) nicht unterstützt.Event logs are not supported on Windows 95, Windows 98, or Windows Millennium Edition.

Hinzufügen und Konfigurieren des EreignisprotokolllistenersTo add and configure the event log listener

  1. Klicken Sie im Projektmappen-Explorer auf "app.config", und wählen Sie Öffnenaus.Right-click app.config in Solution Explorer and choose Open.

    - oder –- or -

    Wenn keine app.config-Datei vorhanden ist:If there is no app.config file,

    1. Klicken Sie im Menü Projekt auf Neues Element hinzufügen.On the Project menu, choose Add New Item.

    2. Wählen Sie im Dialogfeld Neues Element hinzufügen den Eintrag Anwendungskonfigurationsdateiaus.From the Add New Item dialog box, choose Application Configuration File.

    3. Klicken Sie auf Hinzufügen.Click Add.

  2. Suchen Sie den Abschnitt <listeners> in der Anwendungskonfigurationsdatei.Locate the <listeners> section in the application configuration file.

    Sie finden den Abschnitt <listeners> im <source> -Abschnitt mit dem Namensattribut "DefaultSource", der in den <system.diagnostics> -Abschnitt verschachtelt ist, der seinerseits in den <configuration> -Abschnitt der obersten Ebene verschachtelt ist.You will find the <listeners> section in the <source> section with the name attribute "DefaultSource", which is nested under the <system.diagnostics> section, which is nested under the top-level <configuration> section.

  3. Fügen Sie dem <listeners> -Abschnitt dieses Element hinzu:Add this element to that <listeners> section:

    <add name="EventLog"/>  
    
  4. Suchen Sie den Abschnitt <sharedListeners> im <system.diagnostics> -Abschnitt im Abschnitt <configuration> der obersten Ebene.Locate the <sharedListeners> section, in the <system.diagnostics> section, in the top-level <configuration> section.

  5. Fügen Sie dem <sharedListeners> -Abschnitt dieses Element hinzu:Add this element to that <sharedListeners> section:

    <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 Ihrer Anwendung.Replace APPLICATION_NAME with the name of your application.

    Hinweis

    Normalerweise schreiben Anwendungen nur Fehler in das Ereignisprotokoll.Typically, an application writes only errors to the event log. Informationen zum Filtern von Protokollausgaben finden Sie unter Walkthrough: Filtering My.Application.Log Output.For information on filtering log output, see Walkthrough: Filtering My.Application.Log Output.

Schreiben von Ereignisinformationen in das EreignisprotokollTo write event information to the event log

  • Verwenden Sie die My.Application.Log.WriteEntry - oder die My.Application.Log.WriteException -Methode, um Informationen in das Ereignisprotokoll zu schreiben.Use the My.Application.Log.WriteEntry or My.Application.Log.WriteException method to write information to the event log. Weitere Informationen finden Sie unter Vorgehensweise: Schreiben von Protokollmeldungen und Vorgehensweise: Protokollieren von Ausnahmen.For more information, see How to: Write Log Messages and How to: Log Exceptions.

    Nachdem Sie den Ereignisprotokolllistener für eine Assembly konfiguriert haben, empfängt er alle Meldungen, die My.Applcation.Log für die betreffende Assembly schreibt.After you configure the event log listener for an assembly, it receives all messages that My.Applcation.Log writes from that assembly.

Siehe auchSee Also

Microsoft.VisualBasic.Logging.Log
WriteEntry
WriteException
Arbeiten mit AnwendungsprotokollenWorking with Application Logs
Gewusst wie: Protokollieren von AusnahmenHow to: Log Exceptions
Exemplarische Vorgehensweise: Bestimmen, wohin „My.Application.Log“ Informationen schreibtWalkthrough: Determining Where My.Application.Log Writes Information