Table of Contents

Class ThreadContext

Namespace
log4net
Assembly
log4net.dll

The log4net Thread Context.

public sealed class ThreadContext
Inheritance
ThreadContext
Inherited Members

Examples

Example of using the thread context properties to store a username.

        <pre><code class="lang-csharp">ThreadContext.Properties["user"] = userName;

log.Info("This log message has a ThreadContext Property called 'user'");

Example of how to push a message into the context stack

        <pre><code class="lang-csharp">using(ThreadContext.Stacks["NDC"].Push("my context message"))

{ log.Info("This log message has a ThreadContext Stack message that includes 'my context message'");

} // at the end of the using block the message is automatically popped

Remarks

The ThreadContext provides a location for thread specific debugging information to be stored. The ThreadContext properties override any GlobalContext properties with the same name.

The thread context has a properties map and a stack. The properties and stack can be included in the output of log messages. The PatternLayout supports selecting and outputting these properties.

The Thread Context provides a diagnostic context for the current thread. This is an instrument for distinguishing interleaved log output from different sources. Log output is typically interleaved when a server handles multiple clients near-simultaneously.

The Thread Context is managed on a per thread basis.

Properties

Properties

The thread properties map

public static ThreadContextProperties Properties { get; }

Property Value

ThreadContextProperties

The thread properties map

Remarks

The ThreadContext properties override any GlobalContext properties with the same name.

Stacks

The thread stacks

public static ThreadContextStacks Stacks { get; }

Property Value

ThreadContextStacks

stack map

Remarks

The thread local stacks.