LoggingEvent Class | Apache log4net™ SDK Documentation

The internal representation of logging events.
Inheritance Hierarchy

System
Object
log4net.Core
LoggingEvent

Namespace: log4net.Core
Assembly: log4net (in log4net.dll) Version: 2.0.8.0-.NET 4.0
Syntax

C#
VB
C++
F#
Copy

    [SerializableAttribute]
    public class LoggingEvent : ISerializable

    <SerializableAttribute>
    Public Class LoggingEvent
    	Implements ISerializable

    [SerializableAttribute]
    public ref class LoggingEvent : ISerializable

    [<SerializableAttribute>]
    type LoggingEvent =
        class
            interface ISerializable
        end

The LoggingEvent type exposes the following members.

Constructors

| Name | Description
--- | --- | ---
| LoggingEvent(LoggingEventData) | Initializes a new instance of the LoggingEvent class using specific data.
| LoggingEvent(SerializationInfo, StreamingContext) | Serialization constructor
| LoggingEvent(Type, ILoggerRepository, LoggingEventData) | Initializes a new instance of the LoggingEvent class using specific data.
| LoggingEvent(Type, ILoggerRepository, LoggingEventData, FixFlags) | Initializes a new instance of the LoggingEvent class using specific data.
| LoggingEvent(Type, ILoggerRepository, String, Level, Object, Exception) | Initializes a new instance of the LoggingEvent class from the supplied parameters.

Top
Properties

| Name | Description
--- | --- | ---
| Domain | Gets the AppDomain friendly name.
| ExceptionObject | Gets the exception object used to initialize this event.
| Fix | The fixed fields in this event
| Identity | Gets the identity of the current thread principal.
| Level | Gets the Level of the logging event.
| LocationInformation | Gets the location information for this logging event.
| LoggerName | Gets the name of the logger that logged the event.
| MessageObject | Gets the message object used to initialize this event.
| Properties | Additional event specific properties.
| RenderedMessage | Gets the message, rendered through the RendererMap.
| Repository | The ILoggerRepository that this event was created in.
| StartTime | Gets the time when the current process started.
| StartTimeUtc | Gets the UTC time when the current process started.
| ThreadName | Gets the name of the current thread.
| TimeStamp | Gets the time of the logging event.
| TimeStampUtc | Gets UTC the time of the logging event.
| UserName | Gets the name of the current user.

Top
Methods

| Name | Description
--- | --- | ---
| Equals | Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
| Finalize | Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
| FixVolatileData | Obsolete. Fix instance fields that hold volatile data.
| FixVolatileData(Boolean) | Obsolete. Fixes instance fields that hold volatile data.
| FixVolatileData(FixFlags) | Fix the fields specified by the FixFlags parameter
| GetExceptionString | Returns this event's exception's rendered using the RendererMap.
| GetExceptionStrRep | Obsolete. Returns this event's exception's rendered using the RendererMap.
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.)
| GetLoggingEventData | Gets the portable data for this LoggingEvent.
| GetLoggingEventData(FixFlags) | Gets the portable data for this LoggingEvent.
| GetObjectData | Serializes this object into the SerializationInfo provided.
| GetProperties | Get all the composite properties in this event
| GetType | Gets the Type of the current instance. (Inherited from Object.)
| LookupProperty | Lookup a composite property in this event
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.)
| ToString | Returns a String that represents the current Object. (Inherited from Object.)
| WriteRenderedMessage | Write the rendered message to a TextWriter

Top
Fields

| Name | Description
--- | --- | ---
| HostNameProperty | The key into the Properties map for the host name value.
| IdentityProperty | The key into the Properties map for the thread identity value.
| UserNameProperty | The key into the Properties map for the user name value.

Top
Remarks

When an affirmative decision is made to log then a LoggingEvent instance is created. This instance is passed around to the different log4net components.

This class is of concern to those wishing to extend log4net.

Some of the values in instances of LoggingEvent are considered volatile, that is the values are correct at the time the event is delivered to appenders, but will not be consistent at any time afterwards. If an event is to be stored and then processed at a later time these volatile values must be fixed by calling [M:FixVolatileData()]. There is a performance penalty for incurred by calling [M:FixVolatileData()] but it is essential to maintaining data consistency.

See Also

#### Reference

log4net.Core Namespace