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.