common.logging 2.0.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,438 @@
1
+ <?xml version="1.0"?>
2
+ <doc>
3
+ <assembly>
4
+ <name>Common.Logging.EntLib41</name>
5
+ </assembly>
6
+ <members>
7
+ <member name="T:Common.Logging.EntLib.CommonLoggingEntlibTraceListener">
8
+ <summary>
9
+ Use this <see cref="T:System.Diagnostics.TraceListener"/> implementation to route all Entlib logging events to the
10
+ Common.Logging infrastructure.
11
+ </summary>
12
+ <remarks>
13
+ See <see cref="T:Common.Logging.EntLib.CommonLoggingEntlibTraceListenerData"/> for a list of properties to configure.
14
+ </remarks>
15
+ <example>
16
+ To route all <see cref="T:Microsoft.Practices.EnterpriseLibrary.Logging.Logger"/> events to Common.Logging, configure <see cref="T:Common.Logging.EntLib.CommonLoggingEntlibTraceListener"/>:
17
+ <code lang="XML">
18
+ &lt;?xml version="1.0" encoding="utf-8"?&gt;
19
+ &lt;configuration&gt;
20
+ &lt;configSections&gt;
21
+ &lt;section name="loggingConfiguration"
22
+ type="Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.LoggingSettings,
23
+ Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral,
24
+ PublicKeyToken=b03f5f7f11d50a3a" /&gt;
25
+ &lt;/configSections&gt;
26
+ &lt;loggingConfiguration name="Logging Application Block" tracingEnabled="true"
27
+ defaultCategory="General" logWarningsWhenNoCategoriesMatch="true"&gt;
28
+ &lt;listeners&gt;
29
+ &lt;add name="Common.Logging Listener"
30
+ type="Common.Logging.EntLib.CommonLoggingEntlibTraceListener, Common.Logging.EntLib"
31
+ listenerDataType="Common.Logging.EntLib.CommonLoggingEntlibTraceListenerData,
32
+ Common.Logging.EntLib"
33
+ loggerNameFormat="{listenerName}.{sourceName}"
34
+ formatter="Text Formatter"
35
+ /&gt;
36
+ &lt;/listeners&gt;
37
+ &lt;formatters&gt;
38
+ &lt;add template="Timestamp: {timestamp}&amp;#xD;&amp;#xA;Message: {message}&amp;#xD;&amp;#xA;Category:
39
+ {category}&amp;#xD;&amp;#xA;Priority: {priority}&amp;#xD;&amp;#xA;EventId: {eventid}&amp;#xD;&amp;#xA;Severity:
40
+ {severity}&amp;#xD;&amp;#xA;Title:{title}&amp;#xD;&amp;#xA;Machine: {machine}&amp;#xD;&amp;#xA;Application Domain:
41
+ {appDomain}&amp;#xD;&amp;#xA;Process Id: {processId}&amp;#xD;&amp;#xA;Process Name: {processName}&amp;#xD;&amp;#xA;Win32
42
+ Thread Id: {win32ThreadId}&amp;#xD;&amp;#xA;Thread Name: {threadName}&amp;#xD;&amp;#xA;Extended Properties:
43
+ {dictionary({key} - {value}&amp;#xD;&amp;#xA;)}"
44
+ type="Microsoft.Practices.EnterpriseLibrary.Logging.Formatters.TextFormatter,
45
+ Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral,
46
+ PublicKeyToken=b03f5f7f11d50a3a"
47
+ name="Text Formatter" /&gt;
48
+ &lt;/formatters&gt;
49
+ &lt;specialSources&gt;
50
+ &lt;allEvents switchValue="All" name="All Events"&gt;
51
+ &lt;listeners&gt;
52
+ &lt;add name="Test Capturing Listener" /&gt;
53
+ &lt;/listeners&gt;
54
+ &lt;/allEvents&gt;
55
+ &lt;/specialSources&gt;
56
+ &lt;/loggingConfiguration&gt;
57
+ &lt;/configuration&gt;
58
+ </code>
59
+ </example>
60
+ <author>Erich Eichinger</author>
61
+ </member>
62
+ <member name="M:Common.Logging.EntLib.CommonLoggingEntlibTraceListener.#ctor(Common.Logging.EntLib.CommonLoggingEntlibTraceListenerData,Microsoft.Practices.EnterpriseLibrary.Logging.Formatters.ILogFormatter)">
63
+ <summary>
64
+ Initializes this instance from <see cref="T:Common.Logging.EntLib.CommonLoggingEntlibTraceListenerData"/> configuration
65
+ information.
66
+ </summary>
67
+ </member>
68
+ <member name="M:Common.Logging.EntLib.CommonLoggingEntlibTraceListener.Write(System.String)">
69
+ <summary>
70
+ NOT USED BY ENTLIB
71
+ </summary>
72
+ <exception cref="T:System.NotImplementedException"/>
73
+ </member>
74
+ <member name="M:Common.Logging.EntLib.CommonLoggingEntlibTraceListener.WriteLine(System.String)">
75
+ <summary>
76
+ NOT USED BY ENTLIB
77
+ </summary>
78
+ <exception cref="T:System.NotImplementedException"/>
79
+ </member>
80
+ <member name="M:Common.Logging.EntLib.CommonLoggingEntlibTraceListener.TraceData(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.Object)">
81
+ <summary>
82
+ Overridden to redirect to call <see cref="M:Common.Logging.EntLib.CommonLoggingEntlibTraceListener.Log(System.Diagnostics.TraceEventType,System.String,System.Int32,System.String,System.Object[])"/>.
83
+ </summary>
84
+ </member>
85
+ <member name="M:Common.Logging.EntLib.CommonLoggingEntlibTraceListener.Log(System.Diagnostics.TraceEventType,System.String,System.Int32,System.String,System.Object[])">
86
+ <summary>
87
+ Logs the given message to the Common.Logging infrastructure
88
+ </summary>
89
+ </member>
90
+ <member name="P:Common.Logging.EntLib.CommonLoggingEntlibTraceListener.LoggerNameFormat">
91
+ <summary>
92
+ Format to use for creating the logger name. Defaults to "{listenerName}.{sourceName}".
93
+ </summary>
94
+ <remarks>
95
+ Available placeholders are:
96
+ <list type="bullet">
97
+ <item>{listenerName}: the configured name of this listener instance.</item>
98
+ <item>{sourceName}: the trace source name an event originates from (see e.g. <see cref="M:System.Diagnostics.TraceListener.TraceEvent(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.String,System.Object[])"/>.</item>
99
+ </list>
100
+ </remarks>
101
+ </member>
102
+ <member name="T:Common.Logging.EntLib.CommonLoggingEntlibTraceListener.LogEntryMessage">
103
+ <summary>
104
+ The message object to be logged. Overrides <see cref="M:Common.Logging.EntLib.CommonLoggingEntlibTraceListener.LogEntryMessage.ToString"/> to format
105
+ the associated <see cref="T:Microsoft.Practices.EnterpriseLibrary.Logging.LogEntry"/>
106
+ </summary>
107
+ </member>
108
+ <member name="T:Common.Logging.EntLib.CommonLoggingEntlibTraceListenerAssembler">
109
+ <summary>
110
+ This type supports the Enterprise Library infrastructure and is not intended to be used directly from your code.
111
+ Represents the process to build a <see cref="T:Common.Logging.EntLib.CommonLoggingEntlibTraceListener"/> described by a
112
+ <see cref="T:Common.Logging.EntLib.CommonLoggingEntlibTraceListenerData"/> configuration object.
113
+ </summary>
114
+ </member>
115
+ <member name="M:Common.Logging.EntLib.CommonLoggingEntlibTraceListenerAssembler.Assemble(Microsoft.Practices.ObjectBuilder2.IBuilderContext,Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.TraceListenerData,Microsoft.Practices.EnterpriseLibrary.Common.Configuration.IConfigurationSource,Microsoft.Practices.EnterpriseLibrary.Common.Configuration.ObjectBuilder.ConfigurationReflectionCache)">
116
+ <summary>
117
+ This method supports the Enterprise Library infrastructure and is not intended to be used directly from your code.
118
+ Builds a <see cref="T:Common.Logging.EntLib.CommonLoggingEntlibTraceListener"/> described by a
119
+ <see cref="T:Common.Logging.EntLib.CommonLoggingEntlibTraceListenerData"/> configuration object.
120
+ </summary>
121
+ </member>
122
+ <member name="T:Common.Logging.EntLib.CommonLoggingEntlibTraceListenerData">
123
+ <summary>
124
+ Represents the configuration settings that describe a <see cref="T:Common.Logging.EntLib.CommonLoggingEntlibTraceListener"/>.
125
+ </summary>
126
+ </member>
127
+ <member name="P:Common.Logging.EntLib.CommonLoggingEntlibTraceListenerData.LoggerNameFormat">
128
+ <summary>
129
+ The logger name format to use for creating logger names from <see cref="P:Microsoft.Practices.EnterpriseLibrary.Common.Configuration.NamedConfigurationElement.Name"/> and
130
+ </summary>
131
+ </member>
132
+ <member name="P:Common.Logging.EntLib.CommonLoggingEntlibTraceListenerData.Formatter">
133
+ <summary>
134
+ Gets or Sets the formatter name
135
+ </summary>
136
+ </member>
137
+ <member name="T:Common.Logging.EntLib.EntLibLogger">
138
+ <summary>
139
+ Concrete implementation of <see cref="T:Common.Logging.ILog"/> interface specific to Enterprise Logging 4.1.
140
+ </summary>
141
+ <remarks>
142
+ Instances are created by the <see cref="T:Common.Logging.EntLib.EntLibLoggerFactoryAdapter"/>. <see cref="P:Common.Logging.EntLib.EntLibLoggerFactoryAdapter.DefaultPriority"/>
143
+ is used for logging a <see cref="T:Microsoft.Practices.EnterpriseLibrary.Logging.LogEntry"/> to <see cref="M:Microsoft.Practices.EnterpriseLibrary.Logging.LogWriter.Write(Microsoft.Practices.EnterpriseLibrary.Logging.LogEntry)"/>.
144
+ The category name used is the name passed into <see cref="M:Common.Logging.LogManager.GetLogger(System.String)"/>. For configuring logging, see <see cref="T:Common.Logging.EntLib.EntLibLoggerFactoryAdapter"/>.
145
+ </remarks>
146
+ <seealso cref="T:Common.Logging.ILog"/>
147
+ <seealso cref="T:Common.Logging.EntLib.EntLibLoggerFactoryAdapter"/>
148
+ <author>Mark Pollack</author>
149
+ <author>Erich Eichinger</author>
150
+ </member>
151
+ <member name="M:Common.Logging.EntLib.EntLibLogger.#ctor(System.String,Microsoft.Practices.EnterpriseLibrary.Logging.LogWriter,Common.Logging.EntLib.EntLibLoggerSettings)">
152
+ <summary>
153
+ Initializes a new instance of the <see cref="T:Common.Logging.EntLib.EntLibLogger"/> class.
154
+ </summary>
155
+ <param name="category">The category.</param>
156
+ <param name="logWriter">the <see cref="P:Common.Logging.EntLib.EntLibLogger.LogWriter"/> to write log events to.</param>
157
+ <param name="settings">the logger settings</param>
158
+ </member>
159
+ <member name="M:Common.Logging.EntLib.EntLibLogger.WriteInternal(Common.Logging.LogLevel,System.Object,System.Exception)">
160
+ <summary>
161
+ Actually sends the message to the EnterpriseLogging log system.
162
+ </summary>
163
+ <param name="logLevel">the level of this log event.</param>
164
+ <param name="message">the message to log</param>
165
+ <param name="exception">the exception to log (may be null)</param>
166
+ </member>
167
+ <member name="M:Common.Logging.EntLib.EntLibLogger.ShouldLog(Microsoft.Practices.EnterpriseLibrary.Logging.LogEntry)">
168
+ <summary>
169
+ May be overridden for custom filter logic
170
+ </summary>
171
+ <param name="log"></param>
172
+ <returns></returns>
173
+ </member>
174
+ <member name="M:Common.Logging.EntLib.EntLibLogger.WriteLog(Microsoft.Practices.EnterpriseLibrary.Logging.LogEntry)">
175
+ <summary>
176
+ Write the fully populated event to the log.
177
+ </summary>
178
+ </member>
179
+ <member name="M:Common.Logging.EntLib.EntLibLogger.GetTraceEventType(Common.Logging.LogLevel)">
180
+ <summary>
181
+ Translates a <see cref="T:Common.Logging.LogLevel"/> to a <see cref="T:System.Diagnostics.TraceEventType"/>.
182
+ </summary>
183
+ </member>
184
+ <member name="M:Common.Logging.EntLib.EntLibLogger.CreateLogEntry(System.Diagnostics.TraceEventType)">
185
+ <summary>
186
+ Creates a minimal log entry instance that will be passed into <see cref="M:Microsoft.Practices.EnterpriseLibrary.Logging.Logger.ShouldLog(Microsoft.Practices.EnterpriseLibrary.Logging.LogEntry)"/>
187
+ to asap decide, whether this event should be logged.
188
+ </summary>
189
+ <param name="traceEventType">trace event severity.</param>
190
+ <returns></returns>
191
+ </member>
192
+ <member name="M:Common.Logging.EntLib.EntLibLogger.PopulateLogEntry(Microsoft.Practices.EnterpriseLibrary.Logging.LogEntry,System.Object,System.Exception)">
193
+ <summary>
194
+ Configures the log entry.
195
+ </summary>
196
+ <param name="log">The log.</param>
197
+ <param name="message">The message.</param>
198
+ <param name="ex">The ex.</param>
199
+ </member>
200
+ <member name="M:Common.Logging.EntLib.EntLibLogger.AddExceptionInfo(Microsoft.Practices.EnterpriseLibrary.Logging.LogEntry,System.Exception)">
201
+ <summary>
202
+ Adds the exception info.
203
+ </summary>
204
+ <param name="log">The log entry.</param>
205
+ <param name="exception">The exception.</param>
206
+ <returns></returns>
207
+ </member>
208
+ <member name="P:Common.Logging.EntLib.EntLibLogger.Category">
209
+ <summary>
210
+ The category of this logger
211
+ </summary>
212
+ </member>
213
+ <member name="P:Common.Logging.EntLib.EntLibLogger.Settings">
214
+ <summary>
215
+ The settings used by this logger
216
+ </summary>
217
+ </member>
218
+ <member name="P:Common.Logging.EntLib.EntLibLogger.LogWriter">
219
+ <summary>
220
+ The <see cref="P:Common.Logging.EntLib.EntLibLogger.LogWriter"/> used by this logger.
221
+ </summary>
222
+ </member>
223
+ <member name="P:Common.Logging.EntLib.EntLibLogger.IsTraceEnabled">
224
+ <summary>
225
+ Gets a value indicating whether this instance is trace enabled.
226
+ </summary>
227
+ </member>
228
+ <member name="P:Common.Logging.EntLib.EntLibLogger.IsDebugEnabled">
229
+ <summary>
230
+ Gets a value indicating whether this instance is debug enabled.
231
+ </summary>
232
+ </member>
233
+ <member name="P:Common.Logging.EntLib.EntLibLogger.IsInfoEnabled">
234
+ <summary>
235
+ Gets a value indicating whether this instance is info enabled.
236
+ </summary>
237
+ </member>
238
+ <member name="P:Common.Logging.EntLib.EntLibLogger.IsWarnEnabled">
239
+ <summary>
240
+ Gets a value indicating whether this instance is warn enabled.
241
+ </summary>
242
+ </member>
243
+ <member name="P:Common.Logging.EntLib.EntLibLogger.IsErrorEnabled">
244
+ <summary>
245
+ Gets a value indicating whether this instance is error enabled.
246
+ </summary>
247
+ </member>
248
+ <member name="P:Common.Logging.EntLib.EntLibLogger.IsFatalEnabled">
249
+ <summary>
250
+ Gets a value indicating whether this instance is fatal enabled.
251
+ </summary>
252
+ </member>
253
+ <member name="T:Common.Logging.EntLib.EntLibLoggerFactoryAdapter">
254
+ <summary>
255
+ Adapts the EnterpriseLibrary 4.1 logging system to Common.Logging.
256
+ </summary>
257
+ <remarks>
258
+ The following configuration property values may be configured:
259
+ <list type="bullet">
260
+ <item>DefaultPriority (see <see cref="P:Common.Logging.EntLib.EntLibLoggerFactoryAdapter.DefaultPriority"/>)</item>
261
+ <item>ExceptionFormat (see <see cref="P:Common.Logging.EntLib.EntLibLoggerFactoryAdapter.ExceptionFormat"/>)</item>
262
+ </list>
263
+ </remarks>
264
+ <example>
265
+ The following snippet shows how to configure EntLib logging for Common.Logging:
266
+ <code>
267
+ &lt;configuration&gt;
268
+ &lt;configSections&gt;
269
+ &lt;section name="logging" type="Common.Logging.ConfigurationSectionHandler, Common.Logging" /&gt;
270
+ &lt;section name="loggingConfiguration" type="Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.LoggingSettings, Microsoft.Practices.EnterpriseLibrary.Logging, Version=4.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" /&gt;
271
+ &lt;/configSections&gt;
272
+ &lt;common&gt;
273
+ &lt;logging&gt;
274
+ &lt;factoryAdapter type="Common.Logging.EntLib.EntLibLoggerFactoryAdapter, Common.Logging.EntLib41"&gt;
275
+ &lt;arg key="DefaultPriority" value="-1" /&gt;
276
+ &lt;/factoryAdapter&gt;
277
+ &lt;/logging&gt;
278
+ &lt;/common&gt;
279
+ &lt;loggingConfiguration name="Logging Application Block"
280
+ &lt;-- configure enterprise logging application block here --&gt;
281
+ ...
282
+ &lt;/loggingConfiguration&gt;
283
+ &lt;/configuration&gt;
284
+ </code>
285
+ </example>
286
+ <author>Mark Pollack</author>
287
+ <author>Erich Eichinger</author>
288
+ </member>
289
+ <member name="M:Common.Logging.EntLib.EntLibLoggerFactoryAdapter.#ctor">
290
+ <summary>
291
+ Initializes a new instance of the <see cref="T:Common.Logging.EntLib.EntLibLoggerFactoryAdapter"/> class.
292
+ </summary>
293
+ </member>
294
+ <member name="M:Common.Logging.EntLib.EntLibLoggerFactoryAdapter.#ctor(System.Int32,System.String,Microsoft.Practices.EnterpriseLibrary.Logging.LogWriter)">
295
+ <summary>
296
+ Initializes a new instance of the <see cref="T:Common.Logging.EntLib.EntLibLoggerFactoryAdapter"/> class
297
+ with the specified configuration parameters.
298
+ </summary>
299
+ </member>
300
+ <member name="M:Common.Logging.EntLib.EntLibLoggerFactoryAdapter.#ctor(System.Collections.Specialized.NameValueCollection)">
301
+ <summary>
302
+ Initializes a new instance of the <see cref="T:Common.Logging.EntLib.EntLibLoggerFactoryAdapter"/> class.
303
+ </summary>
304
+ <remarks>passed in values are not used, configuration is external to EntLib logging API</remarks>
305
+ <param name="properties">The properties.</param>
306
+ </member>
307
+ <member name="M:Common.Logging.EntLib.EntLibLoggerFactoryAdapter.CreateLogger(System.String)">
308
+ <summary>
309
+ Creates a new <see cref="T:Common.Logging.EntLib.EntLibLogger"/> instance.
310
+ </summary>
311
+ </member>
312
+ <member name="M:Common.Logging.EntLib.EntLibLoggerFactoryAdapter.CreateLogger(System.String,Microsoft.Practices.EnterpriseLibrary.Logging.LogWriter,Common.Logging.EntLib.EntLibLoggerSettings)">
313
+ <summary>
314
+ Creates a new <see cref="T:Common.Logging.EntLib.EntLibLogger"/> instance.
315
+ </summary>
316
+ </member>
317
+ <member name="P:Common.Logging.EntLib.EntLibLoggerFactoryAdapter.DefaultPriority">
318
+ <summary>
319
+ The default priority used to log events.
320
+ </summary>
321
+ <remarks>defaults to <see cref="F:Common.Logging.EntLib.EntLibLoggerSettings.DEFAULTPRIORITY"/></remarks>
322
+ </member>
323
+ <member name="P:Common.Logging.EntLib.EntLibLoggerFactoryAdapter.ExceptionFormat">
324
+ <summary>
325
+ The format string used for formatting exceptions
326
+ </summary>
327
+ <remarks>
328
+ defaults to <see cref="F:Common.Logging.EntLib.EntLibLoggerSettings.DEFAULTEXCEPTIONFORMAT"/>
329
+ </remarks>
330
+ </member>
331
+ <member name="P:Common.Logging.EntLib.EntLibLoggerFactoryAdapter.LogWriter">
332
+ <summary>
333
+ the <see cref="F:Common.Logging.EntLib.EntLibLoggerFactoryAdapter._logWriter"/> to write log events to.
334
+ </summary>
335
+ <remarks>
336
+ defaults to <see cref="P:Microsoft.Practices.EnterpriseLibrary.Logging.Logger.Writer"/>.
337
+ </remarks>
338
+ </member>
339
+ <member name="T:Common.Logging.EntLib.EntLibLoggerSettings">
340
+ <summary>
341
+ Holds configuration settings for <see cref="T:Common.Logging.EntLib.EntLibLogger"/>s.
342
+ </summary>
343
+ <author>Erich Eichinger</author>
344
+ </member>
345
+ <member name="F:Common.Logging.EntLib.EntLibLoggerSettings.DEFAULTPRIORITY">
346
+ <summary>
347
+ the default priority used for logging.
348
+ </summary>
349
+ </member>
350
+ <member name="F:Common.Logging.EntLib.EntLibLoggerSettings.DEFAULTEXCEPTIONFORMAT">
351
+ <summary>
352
+ the default <see cref="F:Common.Logging.EntLib.EntLibLoggerSettings.exceptionFormat"/> used for formatting error message
353
+ </summary>
354
+ <remarks>
355
+ "Exception[ message = $(exception.message), source = $(exception.source), targetsite = $(exception.targetsite), stacktrace = $(exception.stacktrace) ]"
356
+ </remarks>
357
+ </member>
358
+ <member name="F:Common.Logging.EntLib.EntLibLoggerSettings.priority">
359
+ <summary>
360
+ the default priority to be used.
361
+ </summary>
362
+ </member>
363
+ <member name="F:Common.Logging.EntLib.EntLibLoggerSettings.exceptionFormat">
364
+ <summary>
365
+ the exception format to be used.
366
+ </summary>
367
+ </member>
368
+ <member name="M:Common.Logging.EntLib.EntLibLoggerSettings.#ctor(System.Int32,System.String)">
369
+ <summary>
370
+ Initializes a new instance.
371
+ </summary>
372
+ </member>
373
+ <member name="T:Common.Logging.EntLib.NamespaceDoc">
374
+ <summary>
375
+ <para>
376
+ This namespace contains the implementations to plug Microsoft Enterprise Logging Library 4.1. into the Common.Logging infrastructure.
377
+ </para>
378
+ <para>For an example on how to configure
379
+ <list type="bullet">
380
+ <item>Common.Logging to render its output to Entlib, see <see cref="T:Common.Logging.EntLib.EntLibLoggerFactoryAdapter"/>.</item>
381
+ <item>Entlib to render its output to Common.Logging use <see cref="T:Common.Logging.EntLib.CommonLoggingEntlibTraceListener"/>.</item>
382
+ </list>
383
+ </para>
384
+ </summary>
385
+ </member>
386
+ <member name="T:Common.Logging.EntLib.SeverityFilter">
387
+ <summary>
388
+ Filters <see cref="T:Microsoft.Practices.EnterpriseLibrary.Logging.LogEntry"/>s by severity (see <see cref="T:System.Diagnostics.TraceEventType"/>).
389
+ </summary>
390
+ <author>Erich Eichinger</author>
391
+ </member>
392
+ <member name="M:Common.Logging.EntLib.SeverityFilter.#ctor(System.String,System.Int32)">
393
+ <summary>
394
+ Creates a new filter instance
395
+ </summary>
396
+ </member>
397
+ <member name="M:Common.Logging.EntLib.SeverityFilter.#ctor(System.String,System.Diagnostics.TraceEventType)">
398
+ <summary>
399
+ Creates a new filter instance
400
+ </summary>
401
+ </member>
402
+ <member name="M:Common.Logging.EntLib.SeverityFilter.#ctor(System.Collections.Specialized.NameValueCollection)">
403
+ <summary>
404
+ Creates a new filter instance
405
+ </summary>
406
+ </member>
407
+ <member name="M:Common.Logging.EntLib.SeverityFilter.Filter(Microsoft.Practices.EnterpriseLibrary.Logging.LogEntry)">
408
+ <summary>
409
+ Check, if <paramref name="log"/> severity matches <see cref="F:Common.Logging.EntLib.SeverityFilter.severityMask"/>.
410
+ </summary>
411
+ <param name="log"></param>
412
+ <returns></returns>
413
+ </member>
414
+ <member name="M:Common.Logging.EntLib.SeverityFilter.ShouldLog(System.Diagnostics.TraceEventType)">
415
+ <summary>
416
+ Checks, whether the specified severity is allowed to log.
417
+ </summary>
418
+ </member>
419
+ <member name="P:Common.Logging.EntLib.SeverityFilter.SeverityMask">
420
+ <summary>
421
+ Bitmask to identify severity levels that should be logged.
422
+ </summary>
423
+ </member>
424
+ <member name="T:AssemblyDoc">
425
+ <summary>
426
+ <para>
427
+ This assembly contains the adapter to plug Microsoft Enterprise Logging Library 4.1. into the Common.Logging infrastructure.
428
+ </para>
429
+ <para>For an example on how to configure
430
+ <list type="bullet">
431
+ <item>Common.Logging to render its output to Entlib, see <see cref="T:Common.Logging.EntLib.EntLibLoggerFactoryAdapter"/>.</item>
432
+ <item>Entlib to render its output to Common.Logging use <see cref="T:Common.Logging.EntLib.CommonLoggingEntlibTraceListener"/>.</item>
433
+ </list>
434
+ </para>
435
+ </summary>
436
+ </member>
437
+ </members>
438
+ </doc>
@@ -0,0 +1,218 @@
1
+ <?xml version="1.0"?>
2
+ <doc>
3
+ <assembly>
4
+ <name>Common.Logging.Log4Net</name>
5
+ </assembly>
6
+ <members>
7
+ <member name="T:Common.Logging.Log4Net.CommonLoggingAppender">
8
+ <summary>
9
+ Routes log events to Common.Logging infrastructure.
10
+ </summary>
11
+ <example>
12
+ To route all events logged using log4net to Common.Logging, you need to configure this appender as shown below:
13
+ <code>
14
+ &lt;log4net&gt;
15
+ &lt;appender name=&quot;CommonLoggingAppender&quot;
16
+ type=&quot;Common.Logging.Log4Net.CommonLoggingAppender, Common.Logging.Log4Net&quot;&gt;
17
+ &lt;layout type=&quot;log4net.Layout.PatternLayout, log4net&quot;&gt;
18
+ &lt;param name=&quot;ConversionPattern&quot; value=&quot;%level - %class.%method: %message&quot; /&gt;
19
+ &lt;/layout&gt;
20
+ &lt;/appender&gt;
21
+
22
+ &lt;root&gt;
23
+ &lt;level value=&quot;ALL&quot; /&gt;
24
+ &lt;appender-ref ref=&quot;CommonLoggingAppender&quot; /&gt;
25
+ &lt;/root&gt;
26
+ &lt;/log4net&gt;
27
+ </code>
28
+ </example>
29
+ <author>Erich Eichinger</author>
30
+ </member>
31
+ <member name="M:Common.Logging.Log4Net.CommonLoggingAppender.GetClosestLevel(log4net.Core.Level)">
32
+ <summary>
33
+ Gets the closest level supported by Common.Logging of the given log4net level
34
+ </summary>
35
+ </member>
36
+ <member name="M:Common.Logging.Log4Net.CommonLoggingAppender.Append(log4net.Core.LoggingEvent)">
37
+ <summary>
38
+ Sends the given log event to Common.Logging
39
+ </summary>
40
+ </member>
41
+ <member name="P:Common.Logging.Log4Net.CommonLoggingAppender.Layout">
42
+ <summary>
43
+ Get or set the layout for this appender
44
+ </summary>
45
+ </member>
46
+ <member name="T:Common.Logging.Log4Net.CommonLoggingAppender.ExceptionAwareLayout">
47
+ <summary>
48
+ Wrapper class that prevents exceptions from being rendered in the message
49
+ </summary>
50
+ </member>
51
+ <member name="T:Common.Logging.Log4Net.Log4NetLogger">
52
+ <summary>
53
+ Concrete implementation of <see cref="T:Common.Logging.ILog"/> interface specific to log4net 1.2.10.
54
+ </summary>
55
+ <remarks>
56
+ Log4net is capable of outputting extended debug information about where the current
57
+ message was generated: class name, method name, file, line, etc. Log4net assumes that the location
58
+ information should be gathered relative to where Debug() was called.
59
+ When using Common.Logging, Debug() is called in Common.Logging.Log4Net.Log4NetLogger. This means that
60
+ the location information will indicate that Common.Logging.Log4Net.Log4NetLogger always made
61
+ the call to Debug(). We need to know where Common.Logging.ILog.Debug()
62
+ was called. To do this we need to use the log4net.ILog.Logger.Log method and pass in a Type telling
63
+ log4net where in the stack to begin looking for location information.
64
+ </remarks>
65
+ <author>Gilles Bayon</author>
66
+ <author>Erich Eichinger</author>
67
+ </member>
68
+ <member name="M:Common.Logging.Log4Net.Log4NetLogger.#ctor(log4net.Core.ILoggerWrapper)">
69
+ <summary>
70
+ Constructor
71
+ </summary>
72
+ <param name="log"></param>
73
+ </member>
74
+ <member name="M:Common.Logging.Log4Net.Log4NetLogger.WriteInternal(Common.Logging.LogLevel,System.Object,System.Exception)">
75
+ <summary>
76
+ Sends the message to the underlying log4net system.
77
+ </summary>
78
+ <param name="logLevel">the level of this log event.</param>
79
+ <param name="message">the message to log</param>
80
+ <param name="exception">the exception to log (may be null)</param>
81
+ </member>
82
+ <member name="P:Common.Logging.Log4Net.Log4NetLogger.IsTraceEnabled">
83
+ <summary>
84
+ Checks if this logger is enabled for the <see cref="F:Common.Logging.LogLevel.Trace" /> level.
85
+ </summary>
86
+ </member>
87
+ <member name="P:Common.Logging.Log4Net.Log4NetLogger.IsDebugEnabled">
88
+ <summary>
89
+ Checks if this logger is enabled for the <see cref="F:Common.Logging.LogLevel.Debug" /> level.
90
+ </summary>
91
+ </member>
92
+ <member name="P:Common.Logging.Log4Net.Log4NetLogger.IsInfoEnabled">
93
+ <summary>
94
+ Checks if this logger is enabled for the <see cref="F:Common.Logging.LogLevel.Info" /> level.
95
+ </summary>
96
+ </member>
97
+ <member name="P:Common.Logging.Log4Net.Log4NetLogger.IsWarnEnabled">
98
+ <summary>
99
+ Checks if this logger is enabled for the <see cref="F:Common.Logging.LogLevel.Warn" /> level.
100
+ </summary>
101
+ </member>
102
+ <member name="P:Common.Logging.Log4Net.Log4NetLogger.IsErrorEnabled">
103
+ <summary>
104
+ Checks if this logger is enabled for the <see cref="F:Common.Logging.LogLevel.Error" /> level.
105
+ </summary>
106
+ </member>
107
+ <member name="P:Common.Logging.Log4Net.Log4NetLogger.IsFatalEnabled">
108
+ <summary>
109
+ Checks if this logger is enabled for the <see cref="F:Common.Logging.LogLevel.Fatal" /> level.
110
+ </summary>
111
+ </member>
112
+ <member name="T:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter">
113
+ <summary>
114
+ Concrete subclass of ILoggerFactoryAdapter specific to log4net 1.2.10.
115
+ </summary>
116
+ <remarks>
117
+ The following configuration property values may be configured:
118
+ <list type="bullet">
119
+ <item><c>configType</c>: <c>INLINE|FILE|FILE-WATCH|EXTERNAL</c></item>
120
+ <item><c>configFile</c>: log4net configuration file path in case of FILE or FILE-WATCH</item>
121
+ </list>
122
+ The configType values have the following implications:
123
+ <list type="bullet">
124
+ <item>INLINE: simply calls <c>XmlConfigurator.Configure()</c></item>
125
+ <item>FILE: calls <c>XmlConfigurator.Configure(System.IO.FileInfo)</c> using <c>configFile</c>.</item>
126
+ <item>FILE-WATCH: calls <c>XmlConfigurator.ConfigureAndWatch(System.IO.FileInfo)</c> using <c>configFile</c>.</item>
127
+ <item>EXTERNAL: does nothing and expects log4net to be configured elsewhere.</item>
128
+ <item>&lt;any&gt;: calls <c>BasicConfigurator.Configure()</c></item>
129
+ </list>
130
+ </remarks>
131
+ <example>
132
+ The following snippet shows how to configure EntLib logging for Common.Logging:
133
+ <code>
134
+ &lt;configuration&gt;
135
+ &lt;configSections&gt;
136
+ &lt;section name=&quot;logging&quot; type=&quot;Common.Logging.ConfigurationSectionHandler, Common.Logging&quot; /&gt;
137
+ &lt;/configSections&gt;
138
+ &lt;common&gt;
139
+ &lt;logging&gt;
140
+ &lt;factoryAdapter type=&quot;Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter, Common.Logging.Log4Net&quot;&gt;
141
+ &lt;arg key=&quot;configType&quot; value=&quot;FILE&quot; /&gt;
142
+ &lt;arg key=&quot;configFile&quot; value=&quot;~/log4net.config&quot; /&gt;
143
+ &lt;/factoryAdapter&gt;
144
+ &lt;/logging&gt;
145
+ &lt;/common&gt;
146
+ &lt;/configuration&gt;
147
+ </code>
148
+ </example>
149
+ <author>Gilles Bayon</author>
150
+ <author>Erich Eichinger</author>
151
+ </member>
152
+ <member name="M:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter.#ctor(System.Collections.Specialized.NameValueCollection)">
153
+ <summary>
154
+ Constructor
155
+ </summary>
156
+ <param name="properties">configuration properties, see <see cref="T:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter"/> for more.</param>
157
+ </member>
158
+ <member name="M:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter.#ctor(System.Collections.Specialized.NameValueCollection,Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter.ILog4NetRuntime)">
159
+ <summary>
160
+ Constructor accepting configuration properties and an arbitrary
161
+ <see cref="T:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter.ILog4NetRuntime"/> instance.
162
+ </summary>
163
+ <param name="properties">configuration properties, see <see cref="T:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter"/> for more.</param>
164
+ <param name="runtime">a log4net runtime adapter</param>
165
+ </member>
166
+ <member name="M:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter.CreateLogger(System.String)">
167
+ <summary>
168
+ Create a ILog instance by name
169
+ </summary>
170
+ <param name="name"></param>
171
+ <returns></returns>
172
+ </member>
173
+ <member name="T:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter.ILog4NetRuntime">
174
+ <summary>
175
+ Abstract interface to the underlying log4net runtime
176
+ </summary>
177
+ </member>
178
+ <member name="M:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter.ILog4NetRuntime.XmlConfiguratorConfigure">
179
+ <summary>Calls <see cref="M:log4net.Config.XmlConfigurator.Configure"/></summary>
180
+ </member>
181
+ <member name="M:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter.ILog4NetRuntime.XmlConfiguratorConfigure(System.String)">
182
+ <summary>Calls <see cref="M:log4net.Config.XmlConfigurator.Configure(System.IO.FileInfo)"/></summary>
183
+ </member>
184
+ <member name="M:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter.ILog4NetRuntime.XmlConfiguratorConfigureAndWatch(System.String)">
185
+ <summary>Calls <see cref="M:log4net.Config.XmlConfigurator.ConfigureAndWatch(System.IO.FileInfo)"/></summary>
186
+ </member>
187
+ <member name="M:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter.ILog4NetRuntime.BasicConfiguratorConfigure">
188
+ <summary>Calls <see cref="M:log4net.Config.BasicConfigurator.Configure"/></summary>
189
+ </member>
190
+ <member name="M:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter.ILog4NetRuntime.GetLogger(System.String)">
191
+ <summary>Calls <see cref="M:Common.Logging.LogManager.GetLogger(System.String)"/></summary>
192
+ </member>
193
+ <member name="T:Common.Logging.Log4Net.NamespaceDoc">
194
+ <summary>
195
+ <para>
196
+ This namespace contains the implementations to plug log4net 1.2.10 into Common.Logging.
197
+ </para>
198
+ <para>For an example on how to configure
199
+ <list type="bullet">
200
+ <item>Common.Logging to render its output to log4net, see <see cref="T:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter"/>.</item>
201
+ <item>log4net to render its output to Common.Logging use <see cref="T:Common.Logging.Log4Net.CommonLoggingAppender"/>.</item>
202
+ </list>
203
+ </para>
204
+ </summary>
205
+ </member>
206
+ <member name="T:AssemblyDoc">
207
+ <summary>
208
+ <para>This assembly contains the adapter to the log4net 1.2.10 library</para>
209
+ <para>For an example on how to configure
210
+ <list type="bullet">
211
+ <item>Common.Logging to render its output to log4net, see <see cref="T:Common.Logging.Log4Net.Log4NetLoggerFactoryAdapter"/>.</item>
212
+ <item>log4net to render its output to Common.Logging use <see cref="T:Common.Logging.Log4Net.CommonLoggingAppender"/>.</item>
213
+ </list>
214
+ </para>
215
+ </summary>
216
+ </member>
217
+ </members>
218
+ </doc>