1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
<html dir="LTR">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252" />
<meta name="vs_targetSchema" content="http://schemas.microsoft.com/intellisense/ie5" />
<title>LogicalThreadContext Class</title>
<xml>
</xml>
<link rel="stylesheet" type="text/css" href="MSDN.css" />
</head>
<body id="bodyID" class="dtBODY">
<div id="nsbanner">
<div id="bannerrow1">
<table class="bannerparthead" cellspacing="0">
<tr id="hdr">
<td class="runninghead">log4net SDK Reference</td>
<td class="product">
</td>
</tr>
</table>
</div>
<div id="TitleRow">
<h1 class="dtH1">LogicalThreadContext Class</h1>
</div>
</div>
<div id="nstext">
<p> The log4net Logical Thread Context. </p>
<p>For a list of all members of this type, see <a href="log4net.LogicalThreadContextMembers.html">LogicalThreadContext Members</a>.</p>
<p>
<a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpref/html/frlrfSystemObjectClassTopic.asp">System.Object</a>
<br /><b>log4net.LogicalThreadContext</b></p>
<div class="syntax">
<span class="lang">[VisualBasic]</span>
<br />NotInheritablePublicClassLogicalThreadContext</div>
<div class="syntax">
<span class="lang">[C#]</span>
<div>publicsealedclassLogicalThreadContext</div>
</div>
<H4 class="dtH4">Thread Safety</H4>
<P>This type is safe for multithreaded operations.</P>
<h4 class="dtH4">Remarks</h4>
<p> The <code>LogicalThreadContext</code> provides a location for <a href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/cpref/html/frlrfSystemRuntimeRemotingMessagingCallContextClassTopic.asp">CallContext</a> specific debugging information to be stored. The <code>LogicalThreadContext</code> properties override any <a href="log4net.ThreadContext.html">ThreadContext</a> or <a href="log4net.GlobalContext.html">GlobalContext</a> properties with the same name. </p>
<p> The Logical Thread Context has a properties map and a stack. The properties and stack can be included in the output of log messages. The <a href="log4net.Layout.PatternLayout.html">PatternLayout</a> supports selecting and outputting these properties. </p>
<p> The Logical Thread Context provides a diagnostic context for the current call context. 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. </p>
<p> The Logical Thread Context is managed on a per <b>CallContext</b> basis. </p>
<h4 class="dtH4">Example</h4><p>Example of using the thread context properties to store a username. <pre class="code"><span class="lang">[C#]
</span>LogicalThreadContext.Properties["user"] = userName;
log.Info("This log message has a LogicalThreadContext Property called 'user'");
</pre>
Example of how to push a message into the context stack <pre class="code"><span class="lang">[C#]
</span>using(LogicalThreadContext.Stacks["LDC"].Push("my context message"))
{
log.Info("This log message has a LogicalThreadContext Stack message that includes 'my context message'");
} // at the end of the using block the message is automatically popped
</pre>
</p><h4 class="dtH4">Requirements</h4><p><b>Namespace: </b><a href="log4net.html">log4net</a></p><p><b>Assembly: </b>log4net (in log4net.dll)
</p><h4 class="dtH4">See Also</h4><p><a href="log4net.LogicalThreadContextMembers.html">LogicalThreadContext Members</a> | <a href="log4net.html">log4net Namespace</a></p><hr /><div id="footer"><p><a href="http://logging.apache.org/log4net">Copyright 2001-2006 The Apache Software Foundation.</a></p><p>Generated from assembly log4net [1.2.10.0]</p></div></div>
</body>
</html>
|
