How to: Write to an Application Event Log (Visual Basic)

You can use the My.Application.Log and My.Log objects to write information about events that occur in your application. This example shows how to configure an event log listener so My.Application.Log writes tracing information to the Application event log.

You cannot write to the Security log. In order to write to the System log, you must be a member of the LocalSystem or Administrator account.

To view an event log, you can use Server Explorer or Windows Event Viewer. For more information, see ETW Events in the .NET Framework.

To add and configure the event log listener

  1. Right-click app.config in Solution Explorer and choose Open.

    - or -

    If there is no app.config file,

    1. On the Project menu, choose Add New Item.

    2. From the Add New Item dialog box, choose Application Configuration File.

    3. Click Add.

  2. Locate the <listeners> section in the application configuration file.

    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. Add this element to that <listeners> section:

    <add name="EventLog"/>
    
  4. Locate the <sharedListeners> section, in the <system.diagnostics> section, in the top-level <configuration> section.

  5. 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"/>
    

    Replace APPLICATION_NAME with the name of your application.

    Note

    Typically, an application writes only errors to the event log. For information on filtering log output, see Walkthrough: Filtering My.Application.Log Output.

To write event information to the event log

Use the My.Application.Log.WriteEntry or My.Application.Log.WriteException method to write information to the event log. For more information, see How to: Write Log Messages and How to: Log Exceptions.

After you configure the event log listener for an assembly, it receives all messages that My.Application.Log writes from that assembly.

See also