1 <?xml version="1.0" encoding="utf-8"?><doc>
3 <name>System.Diagnostics.TraceSource</name>
6 <member name="T:System.Diagnostics.EventTypeFilter">
7 <summary>Indicates whether a listener should trace based on the event type.</summary>
9 <member name="M:System.Diagnostics.EventTypeFilter.#ctor(System.Diagnostics.SourceLevels)">
10 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.EventTypeFilter"></see> class.</summary>
11 <param name="level">A bitwise combination of the <see cref="T:System.Diagnostics.SourceLevels"></see> values that specifies the event type of the messages to trace.</param>
13 <member name="P:System.Diagnostics.EventTypeFilter.EventType">
14 <summary>Gets or sets the event type of the messages to trace.</summary>
15 <returns>A bitwise combination of the <see cref="System.Diagnostics.SourceLevels"></see> values.</returns>
17 <member name="M:System.Diagnostics.EventTypeFilter.ShouldTrace(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.String,System.Object[],System.Object,System.Object[])">
18 <summary>Determines whether the trace listener should trace the event.</summary>
19 <param name="cache">A <see cref="T:System.Diagnostics.TraceEventCache"></see> that represents the information cache for the trace event.</param>
20 <param name="source">The name of the source.</param>
21 <param name="eventType">One of the <see cref="T:System.Diagnostics.TraceEventType"></see> values.</param>
22 <param name="id">A trace identifier number.</param>
23 <param name="formatOrMessage">The format to use for writing an array of arguments, or a message to write.</param>
24 <param name="args">An array of argument objects.</param>
25 <param name="data1">A trace data object.</param>
26 <param name="data">An array of trace data objects.</param>
27 <returns>true if the trace should be produced; otherwise, false.</returns>
29 <member name="T:System.Diagnostics.CorrelationManager">
30 <summary>Correlates traces that are part of a logical transaction.</summary>
32 <member name="P:System.Diagnostics.CorrelationManager.ActivityId">
33 <summary>Gets or sets the identity for a global activity.</summary>
34 <returns>A <see cref="System.Guid"></see> structure that identifies the global activity.</returns>
36 <member name="P:System.Diagnostics.CorrelationManager.LogicalOperationStack">
37 <summary>Gets the logical operation stack from the call context.</summary>
38 <returns>A <see cref="System.Collections.Stack"></see> object that represents the logical operation stack for the call context.</returns>
40 <member name="M:System.Diagnostics.CorrelationManager.StartLogicalOperation">
41 <summary>Starts a logical operation on a thread.</summary>
43 <member name="M:System.Diagnostics.CorrelationManager.StartLogicalOperation(System.Object)">
44 <summary>Starts a logical operation with the specified identity on a thread.</summary>
45 <param name="operationId">An object identifying the operation.</param>
46 <exception cref="T:System.ArgumentNullException">The <paramref name="operationId">operationId</paramref> parameter is null.</exception>
48 <member name="M:System.Diagnostics.CorrelationManager.StopLogicalOperation">
49 <summary>Stops the current logical operation.</summary>
50 <exception cref="T:System.InvalidOperationException">The <see cref="System.Diagnostics.CorrelationManager.LogicalOperationStack"></see> property is an empty stack.</exception>
52 <member name="T:System.Diagnostics.DefaultTraceListener">
53 <summary>Provides the default output methods and behavior for tracing.</summary>
55 <member name="M:System.Diagnostics.DefaultTraceListener.#ctor">
56 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.DefaultTraceListener"></see> class with &quot;Default&quot; as its <see cref="P:System.Diagnostics.TraceListener.Name"></see> property value.</summary>
58 <member name="P:System.Diagnostics.DefaultTraceListener.AssertUiEnabled">
59 <summary>Gets or sets a value indicating whether the application is running in user-interface mode.</summary>
60 <returns>true if user-interface mode is enabled; otherwise, false.</returns>
62 <member name="M:System.Diagnostics.DefaultTraceListener.Fail(System.String)">
63 <summary>Emits or displays a message and a stack trace for an assertion that always fails.</summary>
64 <param name="message">The message to emit or display.</param>
66 <member name="M:System.Diagnostics.DefaultTraceListener.Fail(System.String,System.String)">
67 <summary>Emits or displays detailed messages and a stack trace for an assertion that always fails.</summary>
68 <param name="message">The message to emit or display.</param>
69 <param name="detailMessage">The detailed message to emit or display.</param>
71 <member name="P:System.Diagnostics.DefaultTraceListener.LogFileName">
72 <summary>Gets or sets the name of a log file to write trace or debug messages to.</summary>
73 <returns>The name of a log file to write trace or debug messages to.</returns>
75 <member name="M:System.Diagnostics.DefaultTraceListener.Write(System.String)">
76 <summary>Writes the output to the OutputDebugString function and to the <see cref="M:System.Diagnostics.Debugger.Log(System.Int32,System.String,System.String)"></see> method.</summary>
77 <param name="message">The message to write to OutputDebugString and <see cref="M:System.Diagnostics.Debugger.Log(System.Int32,System.String,System.String)"></see>.</param>
79 <member name="M:System.Diagnostics.DefaultTraceListener.WriteLine(System.String)">
80 <summary>Writes the output to the OutputDebugString function and to the <see cref="M:System.Diagnostics.Debugger.Log(System.Int32,System.String,System.String)"></see> method, followed by a carriage return and line feed (\r\n).</summary>
81 <param name="message">The message to write to OutputDebugString and <see cref="M:System.Diagnostics.Debugger.Log(System.Int32,System.String,System.String)"></see>.</param>
83 <member name="T:System.Diagnostics.SourceFilter">
84 <summary>Indicates whether a listener should trace a message based on the source of a trace.</summary>
86 <member name="M:System.Diagnostics.SourceFilter.#ctor(System.String)">
87 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.SourceFilter"></see> class, specifying the name of the trace source.</summary>
88 <param name="source">The name of the trace source.</param>
90 <member name="M:System.Diagnostics.SourceFilter.ShouldTrace(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.String,System.Object[],System.Object,System.Object[])">
91 <summary>Determines whether the trace listener should trace the event.</summary>
92 <param name="cache">An object that represents the information cache for the trace event.</param>
93 <param name="source">The name of the source.</param>
94 <param name="eventType">One of the enumeration values that identifies the event type.</param>
95 <param name="id">A trace identifier number.</param>
96 <param name="formatOrMessage">The format to use for writing an array of arguments or a message to write.</param>
97 <param name="args">An array of argument objects.</param>
98 <param name="data1">A trace data object.</param>
99 <param name="data">An array of trace data objects.</param>
100 <returns>true if the trace should be produced; otherwise, false.</returns>
101 <exception cref="T:System.ArgumentNullException"><paramref name="source">source</paramref> is null.</exception>
103 <member name="P:System.Diagnostics.SourceFilter.Source">
104 <summary>Gets or sets the name of the trace source.</summary>
105 <returns>The name of the trace source.</returns>
106 <exception cref="T:System.ArgumentNullException">The value is null.</exception>
108 <member name="T:System.Diagnostics.SourceLevels">
109 <summary>Specifies the levels of trace messages filtered by the source switch and event type filter.</summary>
111 <member name="F:System.Diagnostics.SourceLevels.ActivityTracing">
112 <summary>Allows the <see cref="F:System.Diagnostics.TraceEventType.Stop"></see>, <see cref="F:System.Diagnostics.TraceEventType.Start"></see>, <see cref="F:System.Diagnostics.TraceEventType.Suspend"></see>, <see cref="F:System.Diagnostics.TraceEventType.Transfer"></see>, and <see cref="F:System.Diagnostics.TraceEventType.Resume"></see> events through.</summary>
115 <member name="F:System.Diagnostics.SourceLevels.All">
116 <summary>Allows all events through.</summary>
119 <member name="F:System.Diagnostics.SourceLevels.Critical">
120 <summary>Allows only <see cref="F:System.Diagnostics.TraceEventType.Critical"></see> events through.</summary>
123 <member name="F:System.Diagnostics.SourceLevels.Error">
124 <summary>Allows <see cref="F:System.Diagnostics.TraceEventType.Critical"></see> and <see cref="F:System.Diagnostics.TraceEventType.Error"></see> events through.</summary>
127 <member name="F:System.Diagnostics.SourceLevels.Information">
128 <summary>Allows <see cref="F:System.Diagnostics.TraceEventType.Critical"></see>, <see cref="F:System.Diagnostics.TraceEventType.Error"></see>, <see cref="F:System.Diagnostics.TraceEventType.Warning"></see>, and <see cref="F:System.Diagnostics.TraceEventType.Information"></see> events through.</summary>
131 <member name="F:System.Diagnostics.SourceLevels.Off">
132 <summary>Does not allow any events through.</summary>
135 <member name="F:System.Diagnostics.SourceLevels.Verbose">
136 <summary>Allows <see cref="F:System.Diagnostics.TraceEventType.Critical"></see>, <see cref="F:System.Diagnostics.TraceEventType.Error"></see>, <see cref="F:System.Diagnostics.TraceEventType.Warning"></see>, <see cref="F:System.Diagnostics.TraceEventType.Information"></see>, and <see cref="F:System.Diagnostics.TraceEventType.Verbose"></see> events through.</summary>
139 <member name="F:System.Diagnostics.SourceLevels.Warning">
140 <summary>Allows <see cref="F:System.Diagnostics.TraceEventType.Critical"></see>, <see cref="F:System.Diagnostics.TraceEventType.Error"></see>, and <see cref="F:System.Diagnostics.TraceEventType.Warning"></see> events through.</summary>
143 <member name="T:System.Diagnostics.SourceSwitch">
144 <summary>Provides a multilevel switch to control tracing and debug output without recompiling your code.</summary>
146 <member name="M:System.Diagnostics.SourceSwitch.#ctor(System.String)">
147 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.SourceSwitch"></see> class, specifying the name of the source.</summary>
148 <param name="name">The name of the source.</param>
150 <member name="M:System.Diagnostics.SourceSwitch.#ctor(System.String,System.String)">
151 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.SourceSwitch"></see> class, specifying the display name and the default value for the source switch.</summary>
152 <param name="displayName">The name of the source switch.</param>
153 <param name="defaultSwitchValue">The default value for the switch.</param>
155 <member name="P:System.Diagnostics.SourceSwitch.Level">
156 <summary>Gets or sets the level of the switch.</summary>
157 <returns>One of the <see cref="System.Diagnostics.SourceLevels"></see> values that represents the event level of the switch.</returns>
159 <member name="M:System.Diagnostics.SourceSwitch.OnValueChanged">
160 <summary>Invoked when the value of the <see cref="P:System.Diagnostics.Switch.Value"></see> property changes.</summary>
161 <exception cref="T:System.ArgumentException">The new value of <see cref="System.Diagnostics.Switch.Value"></see> is not one of the <see cref="System.Diagnostics.SourceLevels"></see> values.</exception>
163 <member name="M:System.Diagnostics.SourceSwitch.ShouldTrace(System.Diagnostics.TraceEventType)">
164 <summary>Determines if trace listeners should be called, based on the trace event type.</summary>
165 <param name="eventType">One of the <see cref="T:System.Diagnostics.TraceEventType"></see> values.</param>
166 <returns>True if the trace listeners should be called; otherwise, false.</returns>
168 <member name="T:System.Diagnostics.Switch">
169 <summary>Provides an abstract base class to create new debugging and tracing switches.</summary>
171 <member name="M:System.Diagnostics.Switch.#ctor(System.String,System.String)">
172 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.Switch"></see> class.</summary>
173 <param name="displayName">The name of the switch.</param>
174 <param name="description">The description for the switch.</param>
176 <member name="M:System.Diagnostics.Switch.#ctor(System.String,System.String,System.String)">
177 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.Switch"></see> class, specifying the display name, description, and default value for the switch.</summary>
178 <param name="displayName">The name of the switch.</param>
179 <param name="description">The description of the switch.</param>
180 <param name="defaultSwitchValue">The default value for the switch.</param>
182 <member name="P:System.Diagnostics.Switch.Attributes">
183 <summary>Gets the custom switch attributes defined in the application configuration file.</summary>
184 <returns>A <see cref="System.Collections.Specialized.StringDictionary"></see> containing the case-insensitive custom attributes for the trace switch.</returns>
186 <member name="P:System.Diagnostics.Switch.Description">
187 <summary>Gets a description of the switch.</summary>
188 <returns>The description of the switch. The default value is an empty string (&quot;&quot;).</returns>
190 <member name="P:System.Diagnostics.Switch.DisplayName">
191 <summary>Gets a name used to identify the switch.</summary>
192 <returns>The name used to identify the switch. The default value is an empty string (&quot;&quot;).</returns>
194 <member name="M:System.Diagnostics.Switch.GetSupportedAttributes">
195 <summary>Gets the custom attributes supported by the switch.</summary>
196 <returns>A string array that contains the names of the custom attributes supported by the switch, or null if there no custom attributes are supported.</returns>
198 <member name="M:System.Diagnostics.Switch.OnSwitchSettingChanged">
199 <summary>Invoked when the <see cref="P:System.Diagnostics.Switch.SwitchSetting"></see> property is changed.</summary>
201 <member name="M:System.Diagnostics.Switch.OnValueChanged">
202 <summary>Invoked when the <see cref="P:System.Diagnostics.Switch.Value"></see> property is changed.</summary>
204 <member name="P:System.Diagnostics.Switch.SwitchSetting">
205 <summary>Gets or sets the current setting for this switch.</summary>
206 <returns>The current setting for this switch. The default is zero.</returns>
208 <member name="P:System.Diagnostics.Switch.Value">
209 <summary>Gets or sets the value of the switch.</summary>
210 <returns>A string representing the value of the switch.</returns>
211 <exception cref="T:System.Configuration.ConfigurationErrorsException">The value is null.
213 The value does not consist solely of an optional negative sign followed by a sequence of digits ranging from 0 to 9.
215 The value represents a number less than <see cref="System.Int32.MinValue"></see> or greater than <see cref="System.Int32.MaxValue"></see>.</exception>
217 <member name="T:System.Diagnostics.SwitchAttribute">
218 <summary>Identifies a switch used in an assembly, class, or member.</summary>
220 <member name="M:System.Diagnostics.SwitchAttribute.#ctor(System.String,System.Type)">
221 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.SwitchAttribute"></see> class, specifying the name and the type of the switch.</summary>
222 <param name="switchName">The display name of the switch.</param>
223 <param name="switchType">The type of the switch.</param>
225 <member name="M:System.Diagnostics.SwitchAttribute.GetAll(System.Reflection.Assembly)">
226 <summary>Returns all switch attributes for the specified assembly.</summary>
227 <param name="assembly">The assembly to check for switch attributes.</param>
228 <returns>An array that contains all the switch attributes for the assembly.</returns>
229 <exception cref="T:System.ArgumentNullException"><paramref name="assembly">assembly</paramref> is null.</exception>
231 <member name="P:System.Diagnostics.SwitchAttribute.SwitchDescription">
232 <summary>Gets or sets the description of the switch.</summary>
233 <returns>The description of the switch.</returns>
235 <member name="P:System.Diagnostics.SwitchAttribute.SwitchName">
236 <summary>Gets or sets the display name of the switch.</summary>
237 <returns>The display name of the switch.</returns>
238 <exception cref="T:System.ArgumentNullException"><see cref="System.Diagnostics.SwitchAttribute.SwitchName"></see> is set to null.</exception>
239 <exception cref="T:System.ArgumentException"><see cref="System.Diagnostics.SwitchAttribute.SwitchName"></see> is set to an empty string.</exception>
241 <member name="P:System.Diagnostics.SwitchAttribute.SwitchType">
242 <summary>Gets or sets the type of the switch.</summary>
243 <returns>The type of the switch.</returns>
244 <exception cref="T:System.ArgumentNullException"><see cref="System.Diagnostics.SwitchAttribute.SwitchType"></see> is set to null.</exception>
246 <member name="T:System.Diagnostics.SwitchLevelAttribute">
247 <summary>Identifies the level type for a switch.</summary>
249 <member name="M:System.Diagnostics.SwitchLevelAttribute.#ctor(System.Type)">
250 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.SwitchLevelAttribute"></see> class, specifying the type that determines whether a trace should be written.</summary>
251 <param name="switchLevelType">The <see cref="T:System.Type"></see> that determines whether a trace should be written.</param>
253 <member name="P:System.Diagnostics.SwitchLevelAttribute.SwitchLevelType">
254 <summary>Gets or sets the type that determines whether a trace should be written.</summary>
255 <returns>The <see cref="System.Type"></see> that determines whether a trace should be written.</returns>
256 <exception cref="T:System.ArgumentNullException">The set operation failed because the value is null.</exception>
258 <member name="T:System.Diagnostics.BooleanSwitch">
259 <summary>Provides a simple on/off switch that controls debugging and tracing output.</summary>
261 <member name="M:System.Diagnostics.BooleanSwitch.#ctor(System.String,System.String)">
262 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.BooleanSwitch"></see> class with the specified display name and description.</summary>
263 <param name="displayName">The name to display on a user interface.</param>
264 <param name="description">The description of the switch.</param>
266 <member name="M:System.Diagnostics.BooleanSwitch.#ctor(System.String,System.String,System.String)">
267 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.BooleanSwitch"></see> class with the specified display name, description, and default switch value.</summary>
268 <param name="displayName">The name to display on the user interface.</param>
269 <param name="description">The description of the switch.</param>
270 <param name="defaultSwitchValue">The default value of the switch.</param>
272 <member name="P:System.Diagnostics.BooleanSwitch.Enabled">
273 <summary>Gets or sets a value indicating whether the switch is enabled or disabled.</summary>
274 <returns>true if the switch is enabled; otherwise, false. The default is false.</returns>
275 <exception cref="T:System.Security.SecurityException">The caller does not have the correct permission.</exception>
277 <member name="M:System.Diagnostics.BooleanSwitch.OnValueChanged">
278 <summary>Determines whether the new value of the <see cref="P:System.Diagnostics.Switch.Value"></see> property can be parsed as a Boolean value.</summary>
280 <member name="T:System.Diagnostics.Trace">
281 <summary>Provides a set of methods and properties that help you trace the execution of your code. This class cannot be inherited.</summary>
283 <member name="M:System.Diagnostics.Trace.Assert(System.Boolean)">
284 <summary>Checks for a condition; if the condition is false, displays a message box that shows the call stack.</summary>
285 <param name="condition">The conditional expression to evaluate. If the condition is true, a failure message is not sent and the message box is not displayed.</param>
287 <member name="M:System.Diagnostics.Trace.Assert(System.Boolean,System.String)">
288 <summary>Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.</summary>
289 <param name="condition">The conditional expression to evaluate. If the condition is true, the specified message is not sent and the message box is not displayed.</param>
290 <param name="message">The message to send to the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</param>
292 <member name="M:System.Diagnostics.Trace.Assert(System.Boolean,System.String,System.String)">
293 <summary>Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.</summary>
294 <param name="condition">The conditional expression to evaluate. If the condition is true, the specified messages are not sent and the message box is not displayed.</param>
295 <param name="message">The message to send to the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</param>
296 <param name="detailMessage">The detailed message to send to the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</param>
298 <member name="P:System.Diagnostics.Trace.AutoFlush">
299 <summary>Gets or sets whether <see cref="M:System.Diagnostics.Trace.Flush"></see> should be called on the <see cref="P:System.Diagnostics.Trace.Listeners"></see> after every write.</summary>
300 <returns>true if <see cref="System.Diagnostics.Trace.Flush"></see> is called on the <see cref="System.Diagnostics.Trace.Listeners"></see> after every write; otherwise, false.</returns>
302 <member name="M:System.Diagnostics.Trace.Close">
303 <summary>Flushes the output buffer, and then closes the <see cref="P:System.Diagnostics.Trace.Listeners"></see>.</summary>
305 <member name="P:System.Diagnostics.Trace.CorrelationManager">
306 <summary>Gets the correlation manager for the thread for this trace.</summary>
307 <returns>The <see cref="System.Diagnostics.CorrelationManager"></see> object associated with the thread for this trace.</returns>
309 <member name="M:System.Diagnostics.Trace.Fail(System.String)">
310 <summary>Emits the specified error message.</summary>
311 <param name="message">A message to emit.</param>
313 <member name="M:System.Diagnostics.Trace.Fail(System.String,System.String)">
314 <summary>Emits an error message, and a detailed error message.</summary>
315 <param name="message">A message to emit.</param>
316 <param name="detailMessage">A detailed message to emit.</param>
318 <member name="M:System.Diagnostics.Trace.Flush">
319 <summary>Flushes the output buffer, and causes buffered data to be written to the <see cref="P:System.Diagnostics.Trace.Listeners"></see>.</summary>
321 <member name="M:System.Diagnostics.Trace.Indent">
322 <summary>Increases the current <see cref="P:System.Diagnostics.Trace.IndentLevel"></see> by one.</summary>
324 <member name="P:System.Diagnostics.Trace.IndentLevel">
325 <summary>Gets or sets the indent level.</summary>
326 <returns>The indent level. The default is zero.</returns>
328 <member name="P:System.Diagnostics.Trace.IndentSize">
329 <summary>Gets or sets the number of spaces in an indent.</summary>
330 <returns>The number of spaces in an indent. The default is four.</returns>
332 <member name="P:System.Diagnostics.Trace.Listeners">
333 <summary>Gets the collection of listeners that is monitoring the trace output.</summary>
334 <returns>A <see cref="System.Diagnostics.TraceListenerCollection"></see> that represents a collection of type <see cref="System.Diagnostics.TraceListener"></see> monitoring the trace output.</returns>
336 <member name="M:System.Diagnostics.Trace.Refresh">
337 <summary>Refreshes the trace configuration data.</summary>
339 <member name="M:System.Diagnostics.Trace.TraceError(System.String)">
340 <summary>Writes an error message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection using the specified message.</summary>
341 <param name="message">The informative message to write.</param>
343 <member name="M:System.Diagnostics.Trace.TraceError(System.String,System.Object[])">
344 <summary>Writes an error message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection using the specified array of objects and formatting information.</summary>
345 <param name="format">A format string that contains zero or more format items, which correspond to objects in the args array.</param>
346 <param name="args">An object array containing zero or more objects to format.</param>
348 <member name="M:System.Diagnostics.Trace.TraceInformation(System.String)">
349 <summary>Writes an informational message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection using the specified message.</summary>
350 <param name="message">The informative message to write.</param>
352 <member name="M:System.Diagnostics.Trace.TraceInformation(System.String,System.Object[])">
353 <summary>Writes an informational message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection using the specified array of objects and formatting information.</summary>
354 <param name="format">A format string that contains zero or more format items, which correspond to objects in the args array.</param>
355 <param name="args">An object array containing zero or more objects to format.</param>
357 <member name="M:System.Diagnostics.Trace.TraceWarning(System.String,System.Object[])">
358 <summary>Writes a warning message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection using the specified array of objects and formatting information.</summary>
359 <param name="format">A format string that contains zero or more format items, which correspond to objects in the args array.</param>
360 <param name="args">An object array containing zero or more objects to format.</param>
362 <member name="M:System.Diagnostics.Trace.TraceWarning(System.String)">
363 <summary>Writes a warning message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection using the specified message.</summary>
364 <param name="message">The informative message to write.</param>
366 <member name="M:System.Diagnostics.Trace.Unindent">
367 <summary>Decreases the current <see cref="P:System.Diagnostics.Trace.IndentLevel"></see> by one.</summary>
369 <member name="P:System.Diagnostics.Trace.UseGlobalLock">
370 <summary>Gets or sets a value indicating whether the global lock should be used.</summary>
371 <returns>true if the global lock is to be used; otherwise, false. The default is true.</returns>
373 <member name="M:System.Diagnostics.Trace.Write(System.Object)">
374 <summary>Writes the value of the object&#39;s <see cref="M:System.Object.ToString"></see> method to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</summary>
375 <param name="value">An <see cref="T:System.Object"></see> whose name is sent to the <see cref="P:System.Diagnostics.Trace.Listeners"></see>.</param>
377 <member name="M:System.Diagnostics.Trace.Write(System.String)">
378 <summary>Writes a message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</summary>
379 <param name="message">A message to write.</param>
381 <member name="M:System.Diagnostics.Trace.Write(System.Object,System.String)">
382 <summary>Writes a category name and the value of the object&#39;s <see cref="M:System.Object.ToString"></see> method to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</summary>
383 <param name="value">An <see cref="T:System.Object"></see> name is sent to the <see cref="P:System.Diagnostics.Trace.Listeners"></see>.</param>
384 <param name="category">A category name used to organize the output.</param>
386 <member name="M:System.Diagnostics.Trace.Write(System.String,System.String)">
387 <summary>Writes a category name and a message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</summary>
388 <param name="message">A message to write.</param>
389 <param name="category">A category name used to organize the output.</param>
391 <member name="M:System.Diagnostics.Trace.WriteIf(System.Boolean,System.String,System.String)">
392 <summary>Writes a category name and message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection if a condition is true.</summary>
393 <param name="condition">true to cause a message to be written; otherwise, false.</param>
394 <param name="message">A message to write.</param>
395 <param name="category">A category name used to organize the output.</param>
397 <member name="M:System.Diagnostics.Trace.WriteIf(System.Boolean,System.Object,System.String)">
398 <summary>Writes a category name and the value of the object&#39;s <see cref="M:System.Object.ToString"></see> method to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection if a condition is true.</summary>
399 <param name="condition">true to cause a message to be written; otherwise, false.</param>
400 <param name="value">An <see cref="T:System.Object"></see> whose name is sent to the <see cref="P:System.Diagnostics.Trace.Listeners"></see>.</param>
401 <param name="category">A category name used to organize the output.</param>
403 <member name="M:System.Diagnostics.Trace.WriteIf(System.Boolean,System.Object)">
404 <summary>Writes the value of the object&#39;s <see cref="M:System.Object.ToString"></see> method to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection if a condition is true.</summary>
405 <param name="condition">true to cause a message to be written; otherwise, false.</param>
406 <param name="value">An <see cref="T:System.Object"></see> whose name is sent to the <see cref="P:System.Diagnostics.Trace.Listeners"></see>.</param>
408 <member name="M:System.Diagnostics.Trace.WriteIf(System.Boolean,System.String)">
409 <summary>Writes a message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection if a condition is true.</summary>
410 <param name="condition">true to cause a message to be written; otherwise, false.</param>
411 <param name="message">A message to write.</param>
413 <member name="M:System.Diagnostics.Trace.WriteLine(System.Object)">
414 <summary>Writes the value of the object&#39;s <see cref="M:System.Object.ToString"></see> method to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</summary>
415 <param name="value">An <see cref="T:System.Object"></see> whose name is sent to the <see cref="P:System.Diagnostics.Trace.Listeners"></see>.</param>
417 <member name="M:System.Diagnostics.Trace.WriteLine(System.String)">
418 <summary>Writes a message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</summary>
419 <param name="message">A message to write.</param>
421 <member name="M:System.Diagnostics.Trace.WriteLine(System.Object,System.String)">
422 <summary>Writes a category name and the value of the object&#39;s <see cref="M:System.Object.ToString"></see> method to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</summary>
423 <param name="value">An <see cref="T:System.Object"></see> whose name is sent to the <see cref="P:System.Diagnostics.Trace.Listeners"></see>.</param>
424 <param name="category">A category name used to organize the output.</param>
426 <member name="M:System.Diagnostics.Trace.WriteLine(System.String,System.String)">
427 <summary>Writes a category name and message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</summary>
428 <param name="message">A message to write.</param>
429 <param name="category">A category name used to organize the output.</param>
431 <member name="M:System.Diagnostics.Trace.WriteLineIf(System.Boolean,System.Object,System.String)">
432 <summary>Writes a category name and the value of the object&#39;s <see cref="M:System.Object.ToString"></see> method to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection if a condition is true.</summary>
433 <param name="condition">true to cause a message to be written; otherwise, false.</param>
434 <param name="value">An <see cref="T:System.Object"></see> whose name is sent to the <see cref="P:System.Diagnostics.Trace.Listeners"></see>.</param>
435 <param name="category">A category name used to organize the output.</param>
437 <member name="M:System.Diagnostics.Trace.WriteLineIf(System.Boolean,System.Object)">
438 <summary>Writes the value of the object&#39;s <see cref="M:System.Object.ToString"></see> method to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection if a condition is true.</summary>
439 <param name="condition">true to cause a message to be written; otherwise, false.</param>
440 <param name="value">An <see cref="T:System.Object"></see> whose name is sent to the <see cref="P:System.Diagnostics.Trace.Listeners"></see>.</param>
442 <member name="M:System.Diagnostics.Trace.WriteLineIf(System.Boolean,System.String)">
443 <summary>Writes a message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection if a condition is true.</summary>
444 <param name="condition">true to cause a message to be written; otherwise, false.</param>
445 <param name="message">A message to write.</param>
447 <member name="M:System.Diagnostics.Trace.WriteLineIf(System.Boolean,System.String,System.String)">
448 <summary>Writes a category name and message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection if a condition is true.</summary>
449 <param name="condition">true to cause a message to be written; otherwise, false.</param>
450 <param name="message">A message to write.</param>
451 <param name="category">A category name used to organize the output.</param>
453 <member name="T:System.Diagnostics.TraceEventCache">
454 <summary>Provides trace event data specific to a thread and a process.</summary>
456 <member name="M:System.Diagnostics.TraceEventCache.#ctor">
457 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.TraceEventCache"></see> class.</summary>
459 <member name="P:System.Diagnostics.TraceEventCache.Callstack">
460 <summary>Gets the call stack for the current thread.</summary>
461 <returns>A string containing stack trace information. This value can be an empty string (&quot;&quot;).</returns>
463 <member name="P:System.Diagnostics.TraceEventCache.DateTime">
464 <summary>Gets the date and time at which the event trace occurred.</summary>
465 <returns>A <see cref="System.DateTime"></see> structure whose value is a date and time expressed in Coordinated Universal Time (UTC).</returns>
467 <member name="P:System.Diagnostics.TraceEventCache.LogicalOperationStack">
468 <summary>Gets the correlation data, contained in a stack.</summary>
469 <returns>A <see cref="System.Collections.Stack"></see> containing correlation data.</returns>
471 <member name="P:System.Diagnostics.TraceEventCache.ProcessId">
472 <summary>Gets the unique identifier of the current process.</summary>
473 <returns>The system-generated unique identifier of the current process.</returns>
475 <member name="P:System.Diagnostics.TraceEventCache.ThreadId">
476 <summary>Gets a unique identifier for the current managed thread.</summary>
477 <returns>A string that represents a unique integer identifier for this managed thread.</returns>
479 <member name="P:System.Diagnostics.TraceEventCache.Timestamp">
480 <summary>Gets the current number of ticks in the timer mechanism.</summary>
481 <returns>The tick counter value of the underlying timer mechanism.</returns>
483 <member name="T:System.Diagnostics.TraceEventType">
484 <summary>Identifies the type of event that has caused the trace.</summary>
486 <member name="F:System.Diagnostics.TraceEventType.Critical">
487 <summary>Fatal error or application crash.</summary>
490 <member name="F:System.Diagnostics.TraceEventType.Error">
491 <summary>Recoverable error.</summary>
494 <member name="F:System.Diagnostics.TraceEventType.Information">
495 <summary>Informational message.</summary>
498 <member name="F:System.Diagnostics.TraceEventType.Resume">
499 <summary>Resumption of a logical operation.</summary>
502 <member name="F:System.Diagnostics.TraceEventType.Start">
503 <summary>Starting of a logical operation.</summary>
506 <member name="F:System.Diagnostics.TraceEventType.Stop">
507 <summary>Stopping of a logical operation.</summary>
510 <member name="F:System.Diagnostics.TraceEventType.Suspend">
511 <summary>Suspension of a logical operation.</summary>
514 <member name="F:System.Diagnostics.TraceEventType.Transfer">
515 <summary>Changing of correlation identity.</summary>
518 <member name="F:System.Diagnostics.TraceEventType.Verbose">
519 <summary>Debugging trace.</summary>
522 <member name="F:System.Diagnostics.TraceEventType.Warning">
523 <summary>Noncritical problem.</summary>
526 <member name="T:System.Diagnostics.TraceFilter">
527 <summary>Provides the base class for trace filter implementations.</summary>
529 <member name="M:System.Diagnostics.TraceFilter.#ctor">
530 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.TraceFilter"></see> class.</summary>
532 <member name="M:System.Diagnostics.TraceFilter.ShouldTrace(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.String,System.Object[],System.Object,System.Object[])">
533 <summary>When overridden in a derived class, determines whether the trace listener should trace the event.</summary>
534 <param name="cache">The <see cref="T:System.Diagnostics.TraceEventCache"></see> that contains information for the trace event.</param>
535 <param name="source">The name of the source.</param>
536 <param name="eventType">One of the <see cref="T:System.Diagnostics.TraceEventType"></see> values specifying the type of event that has caused the trace.</param>
537 <param name="id">A trace identifier number.</param>
538 <param name="formatOrMessage">Either the format to use for writing an array of arguments specified by the args parameter, or a message to write.</param>
539 <param name="args">An array of argument objects.</param>
540 <param name="data1">A trace data object.</param>
541 <param name="data">An array of trace data objects.</param>
542 <returns>true to trace the specified event; otherwise, false.</returns>
544 <member name="T:System.Diagnostics.TraceLevel">
545 <summary>Specifies what messages to output for the <see cref="T:System.Diagnostics.Debug"></see>, <see cref="T:System.Diagnostics.Trace"></see> and <see cref="T:System.Diagnostics.TraceSwitch"></see> classes.</summary>
547 <member name="F:System.Diagnostics.TraceLevel.Error">
548 <summary>Output error-handling messages.</summary>
551 <member name="F:System.Diagnostics.TraceLevel.Info">
552 <summary>Output informational messages, warnings, and error-handling messages.</summary>
555 <member name="F:System.Diagnostics.TraceLevel.Off">
556 <summary>Output no tracing and debugging messages.</summary>
559 <member name="F:System.Diagnostics.TraceLevel.Verbose">
560 <summary>Output all debugging and tracing messages.</summary>
563 <member name="F:System.Diagnostics.TraceLevel.Warning">
564 <summary>Output warnings and error-handling messages.</summary>
567 <member name="T:System.Diagnostics.TraceListener">
568 <summary>Provides the abstract base class for the listeners who monitor trace and debug output.</summary>
570 <member name="M:System.Diagnostics.TraceListener.#ctor">
571 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.TraceListener"></see> class.</summary>
573 <member name="M:System.Diagnostics.TraceListener.#ctor(System.String)">
574 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.TraceListener"></see> class using the specified name as the listener.</summary>
575 <param name="name">The name of the <see cref="T:System.Diagnostics.TraceListener"></see>.</param>
577 <member name="P:System.Diagnostics.TraceListener.Attributes">
578 <summary>Gets the custom trace listener attributes defined in the application configuration file.</summary>
579 <returns>A <see cref="System.Collections.Specialized.StringDictionary"></see> containing the custom attributes for the trace listener.</returns>
581 <member name="M:System.Diagnostics.TraceListener.Close">
582 <summary>When overridden in a derived class, closes the output stream so it no longer receives tracing or debugging output.</summary>
584 <member name="M:System.Diagnostics.TraceListener.Dispose">
585 <summary>Releases all resources used by the <see cref="T:System.Diagnostics.TraceListener"></see>.</summary>
587 <member name="M:System.Diagnostics.TraceListener.Dispose(System.Boolean)">
588 <summary>Releases the unmanaged resources used by the <see cref="T:System.Diagnostics.TraceListener"></see> and optionally releases the managed resources.</summary>
589 <param name="disposing">true to release both managed and unmanaged resources; false to release only unmanaged resources.</param>
591 <member name="M:System.Diagnostics.TraceListener.Fail(System.String)">
592 <summary>Emits an error message to the listener you create when you implement the <see cref="T:System.Diagnostics.TraceListener"></see> class.</summary>
593 <param name="message">A message to emit.</param>
595 <member name="M:System.Diagnostics.TraceListener.Fail(System.String,System.String)">
596 <summary>Emits an error message and a detailed error message to the listener you create when you implement the <see cref="T:System.Diagnostics.TraceListener"></see> class.</summary>
597 <param name="message">A message to emit.</param>
598 <param name="detailMessage">A detailed message to emit.</param>
600 <member name="P:System.Diagnostics.TraceListener.Filter">
601 <summary>Gets and sets the trace filter for the trace listener.</summary>
602 <returns>An object derived from the <see cref="System.Diagnostics.TraceFilter"></see> base class.</returns>
604 <member name="M:System.Diagnostics.TraceListener.Flush">
605 <summary>When overridden in a derived class, flushes the output buffer.</summary>
607 <member name="M:System.Diagnostics.TraceListener.GetSupportedAttributes">
608 <summary>Gets the custom attributes supported by the trace listener.</summary>
609 <returns>A string array naming the custom attributes supported by the trace listener, or null if there are no custom attributes.</returns>
611 <member name="P:System.Diagnostics.TraceListener.IndentLevel">
612 <summary>Gets or sets the indent level.</summary>
613 <returns>The indent level. The default is zero.</returns>
615 <member name="P:System.Diagnostics.TraceListener.IndentSize">
616 <summary>Gets or sets the number of spaces in an indent.</summary>
617 <returns>The number of spaces in an indent. The default is four spaces.</returns>
618 <exception cref="T:System.ArgumentOutOfRangeException">Set operation failed because the value is less than zero.</exception>
620 <member name="P:System.Diagnostics.TraceListener.IsThreadSafe">
621 <summary>Gets a value indicating whether the trace listener is thread safe.</summary>
622 <returns>true if the trace listener is thread safe; otherwise, false. The default is false.</returns>
624 <member name="P:System.Diagnostics.TraceListener.Name">
625 <summary>Gets or sets a name for this <see cref="T:System.Diagnostics.TraceListener"></see>.</summary>
626 <returns>A name for this <see cref="System.Diagnostics.TraceListener"></see>. The default is an empty string (&quot;&quot;).</returns>
628 <member name="P:System.Diagnostics.TraceListener.NeedIndent">
629 <summary>Gets or sets a value indicating whether to indent the output.</summary>
630 <returns>true if the output should be indented; otherwise, false.</returns>
632 <member name="M:System.Diagnostics.TraceListener.TraceData(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.Object)">
633 <summary>Writes trace information, a data object and event information to the listener specific output.</summary>
634 <param name="eventCache">A <see cref="T:System.Diagnostics.TraceEventCache"></see> object that contains the current process ID, thread ID, and stack trace information.</param>
635 <param name="source">A name used to identify the output, typically the name of the application that generated the trace event.</param>
636 <param name="eventType">One of the <see cref="T:System.Diagnostics.TraceEventType"></see> values specifying the type of event that has caused the trace.</param>
637 <param name="id">A numeric identifier for the event.</param>
638 <param name="data">The trace data to emit.</param>
640 <member name="M:System.Diagnostics.TraceListener.TraceData(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.Object[])">
641 <summary>Writes trace information, an array of data objects and event information to the listener specific output.</summary>
642 <param name="eventCache">A <see cref="T:System.Diagnostics.TraceEventCache"></see> object that contains the current process ID, thread ID, and stack trace information.</param>
643 <param name="source">A name used to identify the output, typically the name of the application that generated the trace event.</param>
644 <param name="eventType">One of the <see cref="T:System.Diagnostics.TraceEventType"></see> values specifying the type of event that has caused the trace.</param>
645 <param name="id">A numeric identifier for the event.</param>
646 <param name="data">An array of objects to emit as data.</param>
648 <member name="M:System.Diagnostics.TraceListener.TraceEvent(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32)">
649 <summary>Writes trace and event information to the listener specific output.</summary>
650 <param name="eventCache">A <see cref="T:System.Diagnostics.TraceEventCache"></see> object that contains the current process ID, thread ID, and stack trace information.</param>
651 <param name="source">A name used to identify the output, typically the name of the application that generated the trace event.</param>
652 <param name="eventType">One of the <see cref="T:System.Diagnostics.TraceEventType"></see> values specifying the type of event that has caused the trace.</param>
653 <param name="id">A numeric identifier for the event.</param>
655 <member name="M:System.Diagnostics.TraceListener.TraceEvent(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.String)">
656 <summary>Writes trace information, a message, and event information to the listener specific output.</summary>
657 <param name="eventCache">A <see cref="T:System.Diagnostics.TraceEventCache"></see> object that contains the current process ID, thread ID, and stack trace information.</param>
658 <param name="source">A name used to identify the output, typically the name of the application that generated the trace event.</param>
659 <param name="eventType">One of the <see cref="T:System.Diagnostics.TraceEventType"></see> values specifying the type of event that has caused the trace.</param>
660 <param name="id">A numeric identifier for the event.</param>
661 <param name="message">A message to write.</param>
663 <member name="M:System.Diagnostics.TraceListener.TraceEvent(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.String,System.Object[])">
664 <summary>Writes trace information, a formatted array of objects and event information to the listener specific output.</summary>
665 <param name="eventCache">A <see cref="T:System.Diagnostics.TraceEventCache"></see> object that contains the current process ID, thread ID, and stack trace information.</param>
666 <param name="source">A name used to identify the output, typically the name of the application that generated the trace event.</param>
667 <param name="eventType">One of the <see cref="T:System.Diagnostics.TraceEventType"></see> values specifying the type of event that has caused the trace.</param>
668 <param name="id">A numeric identifier for the event.</param>
669 <param name="format">A format string that contains zero or more format items, which correspond to objects in the args array.</param>
670 <param name="args">An object array containing zero or more objects to format.</param>
672 <member name="P:System.Diagnostics.TraceListener.TraceOutputOptions">
673 <summary>Gets or sets the trace output options.</summary>
674 <returns>A bitwise combination of the enumeration values. The default is <see cref="System.Diagnostics.TraceOptions.None"></see>.</returns>
675 <exception cref="T:System.ArgumentOutOfRangeException">Set operation failed because the value is invalid.</exception>
677 <member name="M:System.Diagnostics.TraceListener.TraceTransfer(System.Diagnostics.TraceEventCache,System.String,System.Int32,System.String,System.Guid)">
678 <summary>Writes trace information, a message, a related activity identity and event information to the listener specific output.</summary>
679 <param name="eventCache">A <see cref="T:System.Diagnostics.TraceEventCache"></see> object that contains the current process ID, thread ID, and stack trace information.</param>
680 <param name="source">A name used to identify the output, typically the name of the application that generated the trace event.</param>
681 <param name="id">A numeric identifier for the event.</param>
682 <param name="message">A message to write.</param>
683 <param name="relatedActivityId">A <see cref="T:System.Guid"></see> object identifying a related activity.</param>
685 <member name="M:System.Diagnostics.TraceListener.Write(System.Object)">
686 <summary>Writes the value of the object&#39;s <see cref="M:System.Object.ToString"></see> method to the listener you create when you implement the <see cref="T:System.Diagnostics.TraceListener"></see> class.</summary>
687 <param name="o">An <see cref="T:System.Object"></see> whose fully qualified class name you want to write.</param>
689 <member name="M:System.Diagnostics.TraceListener.Write(System.String)">
690 <summary>When overridden in a derived class, writes the specified message to the listener you create in the derived class.</summary>
691 <param name="message">A message to write.</param>
693 <member name="M:System.Diagnostics.TraceListener.Write(System.Object,System.String)">
694 <summary>Writes a category name and the value of the object&#39;s <see cref="M:System.Object.ToString"></see> method to the listener you create when you implement the <see cref="T:System.Diagnostics.TraceListener"></see> class.</summary>
695 <param name="o">An <see cref="T:System.Object"></see> whose fully qualified class name you want to write.</param>
696 <param name="category">A category name used to organize the output.</param>
698 <member name="M:System.Diagnostics.TraceListener.Write(System.String,System.String)">
699 <summary>Writes a category name and a message to the listener you create when you implement the <see cref="T:System.Diagnostics.TraceListener"></see> class.</summary>
700 <param name="message">A message to write.</param>
701 <param name="category">A category name used to organize the output.</param>
703 <member name="M:System.Diagnostics.TraceListener.WriteIndent">
704 <summary>Writes the indent to the listener you create when you implement this class, and resets the <see cref="P:System.Diagnostics.TraceListener.NeedIndent"></see> property to false.</summary>
706 <member name="M:System.Diagnostics.TraceListener.WriteLine(System.Object)">
707 <summary>Writes the value of the object&#39;s <see cref="M:System.Object.ToString"></see> method to the listener you create when you implement the <see cref="T:System.Diagnostics.TraceListener"></see> class, followed by a line terminator.</summary>
708 <param name="o">An <see cref="T:System.Object"></see> whose fully qualified class name you want to write.</param>
710 <member name="M:System.Diagnostics.TraceListener.WriteLine(System.String)">
711 <summary>When overridden in a derived class, writes a message to the listener you create in the derived class, followed by a line terminator.</summary>
712 <param name="message">A message to write.</param>
714 <member name="M:System.Diagnostics.TraceListener.WriteLine(System.Object,System.String)">
715 <summary>Writes a category name and the value of the object&#39;s <see cref="M:System.Object.ToString"></see> method to the listener you create when you implement the <see cref="T:System.Diagnostics.TraceListener"></see> class, followed by a line terminator.</summary>
716 <param name="o">An <see cref="T:System.Object"></see> whose fully qualified class name you want to write.</param>
717 <param name="category">A category name used to organize the output.</param>
719 <member name="M:System.Diagnostics.TraceListener.WriteLine(System.String,System.String)">
720 <summary>Writes a category name and a message to the listener you create when you implement the <see cref="T:System.Diagnostics.TraceListener"></see> class, followed by a line terminator.</summary>
721 <param name="message">A message to write.</param>
722 <param name="category">A category name used to organize the output.</param>
724 <member name="T:System.Diagnostics.TraceListenerCollection">
725 <summary>Provides a thread-safe list of <see cref="T:System.Diagnostics.TraceListener"></see> objects.</summary>
727 <member name="M:System.Diagnostics.TraceListenerCollection.Add(System.Diagnostics.TraceListener)">
728 <summary>Adds a <see cref="T:System.Diagnostics.TraceListener"></see> to the list.</summary>
729 <param name="listener">A <see cref="T:System.Diagnostics.TraceListener"></see> to add to the list.</param>
730 <returns>The position at which the new listener was inserted.</returns>
732 <member name="M:System.Diagnostics.TraceListenerCollection.AddRange(System.Diagnostics.TraceListener[])">
733 <summary>Adds an array of <see cref="T:System.Diagnostics.TraceListener"></see> objects to the list.</summary>
734 <param name="value">An array of <see cref="T:System.Diagnostics.TraceListener"></see> objects to add to the list.</param>
735 <exception cref="T:System.ArgumentNullException"><paramref name="value">value</paramref> is null.</exception>
737 <member name="M:System.Diagnostics.TraceListenerCollection.AddRange(System.Diagnostics.TraceListenerCollection)">
738 <summary>Adds the contents of another <see cref="T:System.Diagnostics.TraceListenerCollection"></see> to the list.</summary>
739 <param name="value">Another <see cref="T:System.Diagnostics.TraceListenerCollection"></see> whose contents are added to the list.</param>
740 <exception cref="T:System.ArgumentNullException"><paramref name="value">value</paramref> is null.</exception>
742 <member name="M:System.Diagnostics.TraceListenerCollection.Clear">
743 <summary>Clears all the listeners from the list.</summary>
745 <member name="M:System.Diagnostics.TraceListenerCollection.Contains(System.Diagnostics.TraceListener)">
746 <summary>Checks whether the list contains the specified listener.</summary>
747 <param name="listener">A <see cref="T:System.Diagnostics.TraceListener"></see> to find in the list.</param>
748 <returns>true if the listener is in the list; otherwise, false.</returns>
750 <member name="M:System.Diagnostics.TraceListenerCollection.CopyTo(System.Diagnostics.TraceListener[],System.Int32)">
751 <summary>Copies a section of the current <see cref="T:System.Diagnostics.TraceListenerCollection"></see> list to the specified array at the specified index.</summary>
752 <param name="listeners">An array of type <see cref="T:System.Array"></see> to copy the elements into.</param>
753 <param name="index">The starting index number in the current list to copy from.</param>
755 <member name="P:System.Diagnostics.TraceListenerCollection.Count">
756 <summary>Gets the number of listeners in the list.</summary>
757 <returns>The number of listeners in the list.</returns>
759 <member name="M:System.Diagnostics.TraceListenerCollection.GetEnumerator">
760 <summary>Gets an enumerator for this list.</summary>
761 <returns>An enumerator of type <see cref="System.Collections.IEnumerator"></see>.</returns>
763 <member name="M:System.Diagnostics.TraceListenerCollection.IndexOf(System.Diagnostics.TraceListener)">
764 <summary>Gets the index of the specified listener.</summary>
765 <param name="listener">A <see cref="T:System.Diagnostics.TraceListener"></see> to find in the list.</param>
766 <returns>The index of the listener, if it can be found in the list; otherwise, -1.</returns>
768 <member name="M:System.Diagnostics.TraceListenerCollection.Insert(System.Int32,System.Diagnostics.TraceListener)">
769 <summary>Inserts the listener at the specified index.</summary>
770 <param name="index">The position in the list to insert the new <see cref="T:System.Diagnostics.TraceListener"></see>.</param>
771 <param name="listener">A <see cref="T:System.Diagnostics.TraceListener"></see> to insert in the list.</param>
772 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="index">index</paramref> is not a valid index in the list.</exception>
773 <exception cref="T:System.ArgumentException"><paramref name="listener">listener</paramref> is null.</exception>
775 <member name="P:System.Diagnostics.TraceListenerCollection.Item(System.Int32)">
776 <summary>Gets or sets the <see cref="T:System.Diagnostics.TraceListener"></see> at the specified index.</summary>
777 <param name="i">The zero-based index of the <see cref="T:System.Diagnostics.TraceListener"></see> to get from the list.</param>
778 <returns>A <see cref="System.Diagnostics.TraceListener"></see> with the specified index.</returns>
779 <exception cref="T:System.ArgumentNullException">The value is null.</exception>
781 <member name="P:System.Diagnostics.TraceListenerCollection.Item(System.String)">
782 <summary>Gets the first <see cref="T:System.Diagnostics.TraceListener"></see> in the list with the specified name.</summary>
783 <param name="name">The name of the <see cref="T:System.Diagnostics.TraceListener"></see> to get from the list.</param>
784 <returns>The first <see cref="System.Diagnostics.TraceListener"></see> in the list with the given <see cref="System.Diagnostics.TraceListener.Name"></see>. This item returns null if no <see cref="System.Diagnostics.TraceListener"></see> with the given name can be found.</returns>
786 <member name="M:System.Diagnostics.TraceListenerCollection.Remove(System.String)">
787 <summary>Removes from the collection the first <see cref="T:System.Diagnostics.TraceListener"></see> with the specified name.</summary>
788 <param name="name">The name of the <see cref="T:System.Diagnostics.TraceListener"></see> to remove from the list.</param>
790 <member name="M:System.Diagnostics.TraceListenerCollection.Remove(System.Diagnostics.TraceListener)">
791 <summary>Removes from the collection the specified <see cref="T:System.Diagnostics.TraceListener"></see>.</summary>
792 <param name="listener">A <see cref="T:System.Diagnostics.TraceListener"></see> to remove from the list.</param>
794 <member name="M:System.Diagnostics.TraceListenerCollection.RemoveAt(System.Int32)">
795 <summary>Removes from the collection the <see cref="T:System.Diagnostics.TraceListener"></see> at the specified index.</summary>
796 <param name="index">The zero-based index of the <see cref="T:System.Diagnostics.TraceListener"></see> to remove from the list.</param>
797 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="index">index</paramref> is not a valid index in the list.</exception>
799 <member name="M:System.Diagnostics.TraceListenerCollection.System#Collections#ICollection#CopyTo(System.Array,System.Int32)">
800 <summary>Copies a section of the current <see cref="T:System.Diagnostics.TraceListenerCollection"></see> to the specified array of <see cref="T:System.Diagnostics.TraceListener"></see> objects.</summary>
801 <param name="array">The one-dimensional array of <see cref="T:System.Diagnostics.TraceListener"></see> objects that is the destination of the elements copied from the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>. The array must have zero-based indexing.</param>
802 <param name="index">The zero-based index in array at which copying begins.</param>
804 <member name="P:System.Diagnostics.TraceListenerCollection.System#Collections#ICollection#IsSynchronized">
805 <summary>Gets a value indicating whether access to the <see cref="T:System.Diagnostics.TraceListenerCollection"></see> is synchronized (thread safe).</summary>
806 <returns>Always true.</returns>
808 <member name="P:System.Diagnostics.TraceListenerCollection.System#Collections#ICollection#SyncRoot">
809 <summary>Gets an object that can be used to synchronize access to the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</summary>
810 <returns>The current <see cref="System.Diagnostics.TraceListenerCollection"></see> object.</returns>
812 <member name="M:System.Diagnostics.TraceListenerCollection.System#Collections#IList#Add(System.Object)">
813 <summary>Adds a trace listener to the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</summary>
814 <param name="value">The object to add to the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</param>
815 <returns>The position into which the new trace listener was inserted.</returns>
816 <exception cref="T:System.ArgumentException"><paramref name="value">value</paramref> is null.
818 <paramref name="value">value</paramref> is not a <see cref="System.Diagnostics.TraceListener"></see>.</exception>
820 <member name="M:System.Diagnostics.TraceListenerCollection.System#Collections#IList#Contains(System.Object)">
821 <summary>Determines whether the <see cref="T:System.Diagnostics.TraceListenerCollection"></see> contains a specific object.</summary>
822 <param name="value">The object to locate in the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</param>
823 <returns>true if the <see cref="System.Object"></see> is found in the <see cref="System.Diagnostics.TraceListenerCollection"></see>; otherwise, false.</returns>
825 <member name="M:System.Diagnostics.TraceListenerCollection.System#Collections#IList#IndexOf(System.Object)">
826 <summary>Determines the index of a specific object in the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</summary>
827 <param name="value">The object to locate in the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</param>
828 <returns>The index of <paramref name="value">value</paramref> if found in the <see cref="System.Diagnostics.TraceListenerCollection"></see>; otherwise, -1.</returns>
830 <member name="M:System.Diagnostics.TraceListenerCollection.System#Collections#IList#Insert(System.Int32,System.Object)">
831 <summary>Inserts a <see cref="T:System.Diagnostics.TraceListener"></see> object at the specified position in the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</summary>
832 <param name="index">The zero-based index at which value should be inserted.</param>
833 <param name="value">The <see cref="T:System.Diagnostics.TraceListener"></see> object to insert into the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</param>
834 <exception cref="T:System.ArgumentException"><paramref name="value">value</paramref> is not a <see cref="System.Diagnostics.TraceListener"></see> object.</exception>
836 <member name="P:System.Diagnostics.TraceListenerCollection.System#Collections#IList#IsFixedSize">
837 <summary>Gets a value indicating whether the <see cref="T:System.Diagnostics.TraceListenerCollection"></see> has a fixed size.</summary>
838 <returns>Always false.</returns>
840 <member name="P:System.Diagnostics.TraceListenerCollection.System#Collections#IList#IsReadOnly">
841 <summary>Gets a value indicating whether the <see cref="T:System.Diagnostics.TraceListenerCollection"></see> is read-only</summary>
842 <returns>Always false.</returns>
844 <member name="P:System.Diagnostics.TraceListenerCollection.System#Collections#IList#Item(System.Int32)">
845 <summary>Gets or sets the <see cref="T:System.Diagnostics.TraceListener"></see> at the specified index in the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</summary>
846 <param name="index">The zero-based index of the value to get.</param>
847 <returns>The <see cref="System.Diagnostics.TraceListener"></see> at the specified index.</returns>
849 <member name="M:System.Diagnostics.TraceListenerCollection.System#Collections#IList#Remove(System.Object)">
850 <summary>Removes an object from the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</summary>
851 <param name="value">The object to remove from the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</param>
853 <member name="T:System.Diagnostics.TraceOptions">
854 <summary>Specifies trace data options to be written to the trace output.</summary>
856 <member name="F:System.Diagnostics.TraceOptions.Callstack">
857 <summary>Write the call stack, which is represented by the return value of the <see cref="P:System.Environment.StackTrace"></see> property.</summary>
860 <member name="F:System.Diagnostics.TraceOptions.DateTime">
861 <summary>Write the date and time.</summary>
864 <member name="F:System.Diagnostics.TraceOptions.LogicalOperationStack">
865 <summary>Write the logical operation stack, which is represented by the return value of the <see cref="P:System.Diagnostics.CorrelationManager.LogicalOperationStack"></see> property.</summary>
868 <member name="F:System.Diagnostics.TraceOptions.None">
869 <summary>Do not write any elements.</summary>
872 <member name="F:System.Diagnostics.TraceOptions.ProcessId">
873 <summary>Write the process identity, which is represented by the return value of the <see cref="P:System.Diagnostics.Process.Id"></see> property.</summary>
876 <member name="F:System.Diagnostics.TraceOptions.ThreadId">
877 <summary>Write the thread identity, which is represented by the return value of the <see cref="P:System.Threading.Thread.ManagedThreadId"></see> property for the current thread.</summary>
880 <member name="F:System.Diagnostics.TraceOptions.Timestamp">
881 <summary>Write the timestamp, which is represented by the return value of the <see cref="M:System.Diagnostics.Stopwatch.GetTimestamp"></see> method.</summary>
884 <member name="T:System.Diagnostics.TraceSource">
885 <summary>Provides a set of methods and properties that enable applications to trace the execution of code and associate trace messages with their source.</summary>
887 <member name="M:System.Diagnostics.TraceSource.#ctor(System.String)">
888 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.TraceSource"></see> class, using the specified name for the source.</summary>
889 <param name="name">The name of the source (typically, the name of the application).</param>
890 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is null.</exception>
891 <exception cref="T:System.ArgumentException"><paramref name="name">name</paramref> is an empty string (&quot;&quot;).</exception>
893 <member name="M:System.Diagnostics.TraceSource.#ctor(System.String,System.Diagnostics.SourceLevels)">
894 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.TraceSource"></see> class, using the specified name for the source and the default source level at which tracing is to occur.</summary>
895 <param name="name">The name of the source, typically the name of the application.</param>
896 <param name="defaultLevel">A bitwise combination of the enumeration values that specifies the default source level at which to trace.</param>
897 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is null.</exception>
898 <exception cref="T:System.ArgumentException"><paramref name="name">name</paramref> is an empty string (&quot;&quot;).</exception>
900 <member name="P:System.Diagnostics.TraceSource.Attributes">
901 <summary>Gets the custom switch attributes defined in the application configuration file.</summary>
902 <returns>A <see cref="System.Collections.Specialized.StringDictionary"></see> containing the custom attributes for the trace switch.</returns>
904 <member name="M:System.Diagnostics.TraceSource.Close">
905 <summary>Closes all the trace listeners in the trace listener collection.</summary>
907 <member name="M:System.Diagnostics.TraceSource.Flush">
908 <summary>Flushes all the trace listeners in the trace listener collection.</summary>
909 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
911 <member name="M:System.Diagnostics.TraceSource.GetSupportedAttributes">
912 <summary>Gets the custom attributes supported by the trace source.</summary>
913 <returns>A string array naming the custom attributes supported by the trace source, or null if there are no custom attributes.</returns>
915 <member name="P:System.Diagnostics.TraceSource.Listeners">
916 <summary>Gets the collection of trace listeners for the trace source.</summary>
917 <returns>A <see cref="System.Diagnostics.TraceListenerCollection"></see> that contains the active trace listeners associated with the source.</returns>
919 <member name="P:System.Diagnostics.TraceSource.Name">
920 <summary>Gets the name of the trace source.</summary>
921 <returns>The name of the trace source.</returns>
923 <member name="P:System.Diagnostics.TraceSource.Switch">
924 <summary>Gets or sets the source switch value.</summary>
925 <returns>A <see cref="System.Diagnostics.SourceSwitch"></see> object representing the source switch value.</returns>
926 <exception cref="T:System.ArgumentNullException"><see cref="System.Diagnostics.TraceSource.Switch"></see> is set to null.</exception>
928 <member name="M:System.Diagnostics.TraceSource.TraceData(System.Diagnostics.TraceEventType,System.Int32,System.Object)">
929 <summary>Writes trace data to the trace listeners in the <see cref="P:System.Diagnostics.TraceSource.Listeners"></see> collection using the specified event type, event identifier, and trace data.</summary>
930 <param name="eventType">One of the enumeration values that specifies the event type of the trace data.</param>
931 <param name="id">A numeric identifier for the event.</param>
932 <param name="data">The trace data.</param>
933 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
935 <member name="M:System.Diagnostics.TraceSource.TraceData(System.Diagnostics.TraceEventType,System.Int32,System.Object[])">
936 <summary>Writes trace data to the trace listeners in the <see cref="P:System.Diagnostics.TraceSource.Listeners"></see> collection using the specified event type, event identifier, and trace data array.</summary>
937 <param name="eventType">One of the enumeration values that specifies the event type of the trace data.</param>
938 <param name="id">A numeric identifier for the event.</param>
939 <param name="data">An object array containing the trace data.</param>
940 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
942 <member name="M:System.Diagnostics.TraceSource.TraceEvent(System.Diagnostics.TraceEventType,System.Int32)">
943 <summary>Writes a trace event message to the trace listeners in the <see cref="P:System.Diagnostics.TraceSource.Listeners"></see> collection using the specified event type and event identifier.</summary>
944 <param name="eventType">One of the enumeration values that specifies the event type of the trace data.</param>
945 <param name="id">A numeric identifier for the event.</param>
946 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
948 <member name="M:System.Diagnostics.TraceSource.TraceEvent(System.Diagnostics.TraceEventType,System.Int32,System.String)">
949 <summary>Writes a trace event message to the trace listeners in the <see cref="P:System.Diagnostics.TraceSource.Listeners"></see> collection using the specified event type, event identifier, and message.</summary>
950 <param name="eventType">One of the enumeration values that specifies the event type of the trace data.</param>
951 <param name="id">A numeric identifier for the event.</param>
952 <param name="message">The trace message to write.</param>
953 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
955 <member name="M:System.Diagnostics.TraceSource.TraceEvent(System.Diagnostics.TraceEventType,System.Int32,System.String,System.Object[])">
956 <summary>Writes a trace event to the trace listeners in the <see cref="P:System.Diagnostics.TraceSource.Listeners"></see> collection using the specified event type, event identifier, and argument array and format.</summary>
957 <param name="eventType">One of the enumeration values that specifies the event type of the trace data.</param>
958 <param name="id">A numeric identifier for the event.</param>
959 <param name="format">A composite format string that contains text intermixed with zero or more format items, which correspond to objects in the args array.</param>
960 <param name="args">An object array containing zero or more objects to format.</param>
961 <exception cref="T:System.ArgumentNullException"><paramref name="format">format</paramref> is null.</exception>
962 <exception cref="T:System.FormatException"><paramref name="format">format</paramref> is invalid.
964 The number that indicates an argument to format is less than zero, or greater than or equal to the number of specified objects to format.</exception>
965 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
967 <member name="M:System.Diagnostics.TraceSource.TraceInformation(System.String)">
968 <summary>Writes an informational message to the trace listeners in the <see cref="P:System.Diagnostics.TraceSource.Listeners"></see> collection using the specified message.</summary>
969 <param name="message">The informative message to write.</param>
970 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
972 <member name="M:System.Diagnostics.TraceSource.TraceInformation(System.String,System.Object[])">
973 <summary>Writes an informational message to the trace listeners in the <see cref="P:System.Diagnostics.TraceSource.Listeners"></see> collection using the specified object array and formatting information.</summary>
974 <param name="format">A composite format string that contains text intermixed with zero or more format items, which correspond to objects in the args array.</param>
975 <param name="args">An array containing zero or more objects to format.</param>
976 <exception cref="T:System.ArgumentNullException"><paramref name="format">format</paramref> is null.</exception>
977 <exception cref="T:System.FormatException"><paramref name="format">format</paramref> is invalid.
979 The number that indicates an argument to format is less than zero, or greater than or equal to the number of specified objects to format.</exception>
980 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
982 <member name="M:System.Diagnostics.TraceSource.TraceTransfer(System.Int32,System.String,System.Guid)">
983 <summary>Writes a trace transfer message to the trace listeners in the <see cref="P:System.Diagnostics.TraceSource.Listeners"></see> collection using the specified numeric identifier, message, and related activity identifier.</summary>
984 <param name="id">A numeric identifier for the event.</param>
985 <param name="message">The trace message to write.</param>
986 <param name="relatedActivityId">A structure that identifies the related activity.</param>
988 <member name="T:System.Diagnostics.TraceSwitch">
989 <summary>Provides a multilevel switch to control tracing and debug output without recompiling your code.</summary>
991 <member name="M:System.Diagnostics.TraceSwitch.#ctor(System.String,System.String)">
992 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.TraceSwitch"></see> class, using the specified display name and description.</summary>
993 <param name="displayName">The name to display on a user interface.</param>
994 <param name="description">The description of the switch.</param>
996 <member name="M:System.Diagnostics.TraceSwitch.#ctor(System.String,System.String,System.String)">
997 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.TraceSwitch"></see> class, using the specified display name, description, and default value for the switch.</summary>
998 <param name="displayName">The name to display on a user interface.</param>
999 <param name="description">The description of the switch.</param>
1000 <param name="defaultSwitchValue">The default value of the switch.</param>
1002 <member name="P:System.Diagnostics.TraceSwitch.Level">
1003 <summary>Gets or sets the trace level that determines the messages the switch allows.</summary>
1004 <returns>One of the <see cref="System.Diagnostics.TraceLevel"></see> values that that specifies the level of messages that are allowed by the switch.</returns>
1005 <exception cref="T:System.ArgumentException"><see cref="System.Diagnostics.TraceSwitch.Level"></see> is set to a value that is not one of the <see cref="System.Diagnostics.TraceLevel"></see> values.</exception>
1007 <member name="M:System.Diagnostics.TraceSwitch.OnSwitchSettingChanged">
1008 <summary>Updates and corrects the level for this switch.</summary>
1010 <member name="M:System.Diagnostics.TraceSwitch.OnValueChanged">
1011 <summary>Sets the <see cref="P:System.Diagnostics.Switch.SwitchSetting"></see> property to the integer equivalent of the <see cref="P:System.Diagnostics.Switch.Value"></see> property.</summary>
1013 <member name="P:System.Diagnostics.TraceSwitch.TraceError">
1014 <summary>Gets a value indicating whether the switch allows error-handling messages.</summary>
1015 <returns>true if the <see cref="System.Diagnostics.TraceSwitch.Level"></see> property is set to <see cref="System.Diagnostics.TraceLevel.Error"></see>, <see cref="System.Diagnostics.TraceLevel.Warning"></see>, <see cref="System.Diagnostics.TraceLevel.Info"></see>, or <see cref="System.Diagnostics.TraceLevel.Verbose"></see>; otherwise, false.</returns>
1017 <member name="P:System.Diagnostics.TraceSwitch.TraceInfo">
1018 <summary>Gets a value indicating whether the switch allows informational messages.</summary>
1019 <returns>true if the <see cref="System.Diagnostics.TraceSwitch.Level"></see> property is set to <see cref="System.Diagnostics.TraceLevel.Info"></see> or <see cref="System.Diagnostics.TraceLevel.Verbose"></see>; otherwise, false.</returns>
1021 <member name="P:System.Diagnostics.TraceSwitch.TraceVerbose">
1022 <summary>Gets a value indicating whether the switch allows all messages.</summary>
1023 <returns>true if the <see cref="System.Diagnostics.TraceSwitch.Level"></see> property is set to <see cref="System.Diagnostics.TraceLevel.Verbose"></see>; otherwise, false.</returns>
1025 <member name="P:System.Diagnostics.TraceSwitch.TraceWarning">
1026 <summary>Gets a value indicating whether the switch allows warning messages.</summary>
1027 <returns>true if the <see cref="System.Diagnostics.TraceSwitch.Level"></see> property is set to <see cref="System.Diagnostics.TraceLevel.Warning"></see>, <see cref="System.Diagnostics.TraceLevel.Info"></see>, or <see cref="System.Diagnostics.TraceLevel.Verbose"></see>; otherwise, false.</returns>