Log Class

Definition

Provides a property and methods for writing event and exception information to the application's log listeners.

public class Log
Inheritance
Log
Derived

Inherited Members

System.Object

Examples

This example shows how to use the My.Application.Log.WriteEntry method to log tracing information. For more information, see How to: Write Log Messages.

Public Sub TracingTest(ByVal fileName As String)
    My.Application.Log.WriteEntry( 
        "Entering TracingTest with argument " & 
        fileName & ".")
    ' Code to trace goes here.
    My.Application.Log.WriteEntry( 
        "Exiting TracingTest with argument " & 
        fileName & ".")
End Sub

Remarks

The My.Application.Log object provides a straightforward entry point from which to access the .NET Framework's logging services. The WriteEntry and WriteException methods write messages to the application's log listeners. The listeners can be configured by the application's configuration file. For more information, see Walkthrough: Changing Where My.Application.Log Writes Information and Working with Application Logs.

The My.Application.Log object is available only for client applications. For Web applications, use My.Log. For more information, see AspLog.

The following table lists examples of tasks involving the My.Application.Log object.

To See
Write event information to the application's log listeners How to: Write Log Messages
Write exception information to the application's log listeners How to: Log Exceptions
Determine where My.Application.Log writes information Walkthrough: Determining Where My.Application.Log Writes Information

Constructors

Log()

Initializes a new instance of the Log class.

Log(String)

Initializes a new instance of the Log class.

Properties

DefaultFileLogWriter

Gets the file the FileLogTraceListener object that underlies the Log object.

TraceSource

Gets to the TraceSource object that underlies the Log object.

Methods

InitializeWithDefaultsSinceNoConfigExists()

Creates a new FileLogTraceListener object and adds it to the Listeners collection.

WriteEntry(String)

Writes a message to the application's log listeners.

WriteEntry(String, TraceEventType)

Writes a message to the application's log listeners.

WriteEntry(String, TraceEventType, Int32)

Writes a message to the application's log listeners.

WriteException(Exception)

Writes exception information to the application's log listeners.

WriteException(Exception, TraceEventType, String)

Writes exception information to the application's log listeners.

WriteException(Exception, TraceEventType, String, Int32)

Writes exception information to the application's log listeners.