1 <?xml version="1.0" encoding="utf-8"?><doc>
3 <name>System.Diagnostics.TraceSource</name>
6 <member name="T:System.Diagnostics.BooleanSwitch">
7 <summary>Provides a simple on/off switch that controls debugging and tracing output.</summary>
9 <member name="M:System.Diagnostics.BooleanSwitch.#ctor(System.String,System.String)">
10 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.BooleanSwitch"></see> class with the specified display name and description.</summary>
11 <param name="displayName">The name to display on a user interface.</param>
12 <param name="description">The description of the switch.</param>
14 <member name="M:System.Diagnostics.BooleanSwitch.#ctor(System.String,System.String,System.String)">
15 <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>
16 <param name="displayName">The name to display on the user interface.</param>
17 <param name="description">The description of the switch.</param>
18 <param name="defaultSwitchValue">The default value of the switch.</param>
20 <member name="P:System.Diagnostics.BooleanSwitch.Enabled">
21 <summary>Gets or sets a value indicating whether the switch is enabled or disabled.</summary>
22 <returns><see langword="true"></see> if the switch is enabled; otherwise, <see langword="false"></see>. The default is <see langword="false"></see>.</returns>
23 <exception cref="T:System.Security.SecurityException">The caller does not have the correct permission.</exception>
25 <member name="M:System.Diagnostics.BooleanSwitch.OnValueChanged">
26 <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>
28 <member name="T:System.Diagnostics.EventTypeFilter">
29 <summary>Indicates whether a listener should trace based on the event type.</summary>
31 <member name="M:System.Diagnostics.EventTypeFilter.#ctor(System.Diagnostics.SourceLevels)">
32 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.EventTypeFilter"></see> class.</summary>
33 <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>
35 <member name="P:System.Diagnostics.EventTypeFilter.EventType">
36 <summary>Gets or sets the event type of the messages to trace.</summary>
37 <returns>A bitwise combination of the <see cref="T:System.Diagnostics.SourceLevels"></see> values.</returns>
39 <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[])">
40 <summary>Determines whether the trace listener should trace the event.</summary>
41 <param name="cache">A <see cref="T:System.Diagnostics.TraceEventCache"></see> that represents the information cache for the trace event.</param>
42 <param name="source">The name of the source.</param>
43 <param name="eventType">One of the <see cref="T:System.Diagnostics.TraceEventType"></see> values.</param>
44 <param name="id">A trace identifier number.</param>
45 <param name="formatOrMessage">The format to use for writing an array of arguments, or a message to write.</param>
46 <param name="args">An array of argument objects.</param>
47 <param name="data1">A trace data object.</param>
48 <param name="data">An array of trace data objects.</param>
49 <returns><see langword="true"></see> if the trace should be produced; otherwise, <see langword="false"></see>.</returns>
51 <member name="T:System.Diagnostics.SwitchLevelAttribute">
52 <summary>Identifies the level type for a switch.</summary>
54 <member name="M:System.Diagnostics.SwitchLevelAttribute.#ctor(System.Type)">
55 <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>
56 <param name="switchLevelType">The <see cref="T:System.Type"></see> that determines whether a trace should be written.</param>
58 <member name="P:System.Diagnostics.SwitchLevelAttribute.SwitchLevelType">
59 <summary>Gets or sets the type that determines whether a trace should be written.</summary>
60 <returns>The <see cref="T:System.Type"></see> that determines whether a trace should be written.</returns>
61 <exception cref="T:System.ArgumentNullException">The set operation failed because the value is <see langword="null"></see>.</exception>
63 <member name="T:System.Diagnostics.SwitchAttribute">
64 <summary>Identifies a switch used in an assembly, class, or member.</summary>
66 <member name="M:System.Diagnostics.SwitchAttribute.#ctor(System.String,System.Type)">
67 <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>
68 <param name="switchName">The display name of the switch.</param>
69 <param name="switchType">The type of the switch.</param>
71 <member name="M:System.Diagnostics.SwitchAttribute.GetAll(System.Reflection.Assembly)">
72 <summary>Returns all switch attributes for the specified assembly.</summary>
73 <param name="assembly">The assembly to check for switch attributes.</param>
74 <returns>An array that contains all the switch attributes for the assembly.</returns>
75 <exception cref="T:System.ArgumentNullException"><paramref name="assembly">assembly</paramref> is <see langword="null"></see>.</exception>
77 <member name="P:System.Diagnostics.SwitchAttribute.SwitchDescription">
78 <summary>Gets or sets the description of the switch.</summary>
79 <returns>The description of the switch.</returns>
81 <member name="P:System.Diagnostics.SwitchAttribute.SwitchName">
82 <summary>Gets or sets the display name of the switch.</summary>
83 <returns>The display name of the switch.</returns>
84 <exception cref="T:System.ArgumentNullException"><see cref="System.Diagnostics.SwitchAttribute.SwitchName"></see> is set to <see langword="null"></see>.</exception>
85 <exception cref="T:System.ArgumentException"><see cref="System.Diagnostics.SwitchAttribute.SwitchName"></see> is set to an empty string.</exception>
87 <member name="P:System.Diagnostics.SwitchAttribute.SwitchType">
88 <summary>Gets or sets the type of the switch.</summary>
89 <returns>The type of the switch.</returns>
90 <exception cref="T:System.ArgumentNullException"><see cref="System.Diagnostics.SwitchAttribute.SwitchType"></see> is set to <see langword="null"></see>.</exception>
92 <member name="T:System.Diagnostics.Switch">
93 <summary>Provides an abstract base class to create new debugging and tracing switches.</summary>
95 <member name="M:System.Diagnostics.Switch.#ctor(System.String,System.String)">
96 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.Switch"></see> class.</summary>
97 <param name="displayName">The name of the switch.</param>
98 <param name="description">The description for the switch.</param>
100 <member name="M:System.Diagnostics.Switch.#ctor(System.String,System.String,System.String)">
101 <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>
102 <param name="displayName">The name of the switch.</param>
103 <param name="description">The description of the switch.</param>
104 <param name="defaultSwitchValue">The default value for the switch.</param>
106 <member name="P:System.Diagnostics.Switch.Attributes">
107 <summary>Gets the custom switch attributes defined in the application configuration file.</summary>
108 <returns>A <see cref="T:System.Collections.Specialized.StringDictionary"></see> containing the case-insensitive custom attributes for the trace switch.</returns>
110 <member name="P:System.Diagnostics.Switch.Description">
111 <summary>Gets a description of the switch.</summary>
112 <returns>The description of the switch. The default value is an empty string (&quot;&quot;).</returns>
114 <member name="P:System.Diagnostics.Switch.DisplayName">
115 <summary>Gets a name used to identify the switch.</summary>
116 <returns>The name used to identify the switch. The default value is an empty string (&quot;&quot;).</returns>
118 <member name="M:System.Diagnostics.Switch.GetSupportedAttributes">
119 <summary>Gets the custom attributes supported by the switch.</summary>
120 <returns>A string array that contains the names of the custom attributes supported by the switch, or <see langword="null"></see> if there no custom attributes are supported.</returns>
122 <member name="M:System.Diagnostics.Switch.OnSwitchSettingChanged">
123 <summary>Invoked when the <see cref="P:System.Diagnostics.Switch.SwitchSetting"></see> property is changed.</summary>
125 <member name="M:System.Diagnostics.Switch.OnValueChanged">
126 <summary>Invoked when the <see cref="P:System.Diagnostics.Switch.Value"></see> property is changed.</summary>
128 <member name="P:System.Diagnostics.Switch.SwitchSetting">
129 <summary>Gets or sets the current setting for this switch.</summary>
130 <returns>The current setting for this switch. The default is zero.</returns>
132 <member name="P:System.Diagnostics.Switch.Value">
133 <summary>Gets or sets the value of the switch.</summary>
134 <returns>A string representing the value of the switch.</returns>
135 <exception cref="T:System.Configuration.ConfigurationErrorsException">The value is <see langword="null"></see>.
137 The value does not consist solely of an optional negative sign followed by a sequence of digits ranging from 0 to 9.
139 The value represents a number less than <see cref="System.Int32.MinValue"></see> or greater than <see cref="System.Int32.MaxValue"></see>.</exception>
141 <member name="T:System.Diagnostics.DefaultTraceListener">
142 <summary>Provides the default output methods and behavior for tracing.</summary>
144 <member name="M:System.Diagnostics.DefaultTraceListener.#ctor">
145 <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>
147 <member name="P:System.Diagnostics.DefaultTraceListener.AssertUiEnabled">
148 <summary>Gets or sets a value indicating whether the application is running in user-interface mode.</summary>
149 <returns><see langword="true"></see> if user-interface mode is enabled; otherwise, <see langword="false"></see>.</returns>
151 <member name="M:System.Diagnostics.DefaultTraceListener.Fail(System.String)">
152 <summary>Emits or displays a message and a stack trace for an assertion that always fails.</summary>
153 <param name="message">The message to emit or display.</param>
155 <member name="M:System.Diagnostics.DefaultTraceListener.Fail(System.String,System.String)">
156 <summary>Emits or displays detailed messages and a stack trace for an assertion that always fails.</summary>
157 <param name="message">The message to emit or display.</param>
158 <param name="detailMessage">The detailed message to emit or display.</param>
160 <member name="P:System.Diagnostics.DefaultTraceListener.LogFileName">
161 <summary>Gets or sets the name of a log file to write trace or debug messages to.</summary>
162 <returns>The name of a log file to write trace or debug messages to.</returns>
164 <member name="M:System.Diagnostics.DefaultTraceListener.Write(System.String)">
165 <summary>Writes the output to the <see langword="OutputDebugString"></see> function and to the <see cref="M:System.Diagnostics.Debugger.Log(System.Int32,System.String,System.String)"></see> method.</summary>
166 <param name="message">The message to write to <see langword="OutputDebugString"></see> and <see cref="M:System.Diagnostics.Debugger.Log(System.Int32,System.String,System.String)"></see>.</param>
168 <member name="M:System.Diagnostics.DefaultTraceListener.WriteLine(System.String)">
169 <summary>Writes the output to the <see langword="OutputDebugString"></see> 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>
170 <param name="message">The message to write to <see langword="OutputDebugString"></see> and <see cref="M:System.Diagnostics.Debugger.Log(System.Int32,System.String,System.String)"></see>.</param>
172 <member name="T:System.Diagnostics.CorrelationManager">
173 <summary>Correlates traces that are part of a logical transaction.</summary>
175 <member name="P:System.Diagnostics.CorrelationManager.ActivityId">
176 <summary>Gets or sets the identity for a global activity.</summary>
177 <returns>A <see cref="T:System.Guid"></see> structure that identifies the global activity.</returns>
179 <member name="P:System.Diagnostics.CorrelationManager.LogicalOperationStack">
180 <summary>Gets the logical operation stack from the call context.</summary>
181 <returns>A <see cref="T:System.Collections.Stack"></see> object that represents the logical operation stack for the call context.</returns>
183 <member name="M:System.Diagnostics.CorrelationManager.StartLogicalOperation">
184 <summary>Starts a logical operation on a thread.</summary>
186 <member name="M:System.Diagnostics.CorrelationManager.StartLogicalOperation(System.Object)">
187 <summary>Starts a logical operation with the specified identity on a thread.</summary>
188 <param name="operationId">An object identifying the operation.</param>
189 <exception cref="T:System.ArgumentNullException">The <paramref name="operationId">operationId</paramref> parameter is <see langword="null"></see>.</exception>
191 <member name="M:System.Diagnostics.CorrelationManager.StopLogicalOperation">
192 <summary>Stops the current logical operation.</summary>
193 <exception cref="T:System.InvalidOperationException">The <see cref="System.Diagnostics.CorrelationManager.LogicalOperationStack"></see> property is an empty stack.</exception>
195 <member name="T:System.Diagnostics.SourceSwitch">
196 <summary>Provides a multilevel switch to control tracing and debug output without recompiling your code.</summary>
198 <member name="M:System.Diagnostics.SourceSwitch.#ctor(System.String)">
199 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.SourceSwitch"></see> class, specifying the name of the source.</summary>
200 <param name="name">The name of the source.</param>
202 <member name="M:System.Diagnostics.SourceSwitch.#ctor(System.String,System.String)">
203 <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>
204 <param name="displayName">The name of the source switch.</param>
205 <param name="defaultSwitchValue">The default value for the switch.</param>
207 <member name="P:System.Diagnostics.SourceSwitch.Level">
208 <summary>Gets or sets the level of the switch.</summary>
209 <returns>One of the <see cref="T:System.Diagnostics.SourceLevels"></see> values that represents the event level of the switch.</returns>
211 <member name="M:System.Diagnostics.SourceSwitch.OnValueChanged">
212 <summary>Invoked when the value of the <see cref="P:System.Diagnostics.Switch.Value"></see> property changes.</summary>
213 <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>
215 <member name="M:System.Diagnostics.SourceSwitch.ShouldTrace(System.Diagnostics.TraceEventType)">
216 <summary>Determines if trace listeners should be called, based on the trace event type.</summary>
217 <param name="eventType">One of the <see cref="T:System.Diagnostics.TraceEventType"></see> values.</param>
218 <returns><see langword="True"></see> if the trace listeners should be called; otherwise, <see langword="false"></see>.</returns>
220 <member name="T:System.Diagnostics.SourceLevels">
221 <summary>Specifies the levels of trace messages filtered by the source switch and event type filter.</summary>
223 <member name="F:System.Diagnostics.SourceLevels.ActivityTracing">
224 <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>
227 <member name="F:System.Diagnostics.SourceLevels.All">
228 <summary>Allows all events through.</summary>
231 <member name="F:System.Diagnostics.SourceLevels.Critical">
232 <summary>Allows only <see cref="F:System.Diagnostics.TraceEventType.Critical"></see> events through.</summary>
235 <member name="F:System.Diagnostics.SourceLevels.Error">
236 <summary>Allows <see cref="F:System.Diagnostics.TraceEventType.Critical"></see> and <see cref="F:System.Diagnostics.TraceEventType.Error"></see> events through.</summary>
239 <member name="F:System.Diagnostics.SourceLevels.Information">
240 <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>
243 <member name="F:System.Diagnostics.SourceLevels.Off">
244 <summary>Does not allow any events through.</summary>
247 <member name="F:System.Diagnostics.SourceLevels.Verbose">
248 <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>
251 <member name="F:System.Diagnostics.SourceLevels.Warning">
252 <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>
255 <member name="T:System.Diagnostics.SourceFilter">
256 <summary>Indicates whether a listener should trace a message based on the source of a trace.</summary>
258 <member name="M:System.Diagnostics.SourceFilter.#ctor(System.String)">
259 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.SourceFilter"></see> class, specifying the name of the trace source.</summary>
260 <param name="source">The name of the trace source.</param>
262 <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[])">
263 <summary>Determines whether the trace listener should trace the event.</summary>
264 <param name="cache">An object that represents the information cache for the trace event.</param>
265 <param name="source">The name of the source.</param>
266 <param name="eventType">One of the enumeration values that identifies the event type.</param>
267 <param name="id">A trace identifier number.</param>
268 <param name="formatOrMessage">The format to use for writing an array of arguments or a message to write.</param>
269 <param name="args">An array of argument objects.</param>
270 <param name="data1">A trace data object.</param>
271 <param name="data">An array of trace data objects.</param>
272 <returns><see langword="true"></see> if the trace should be produced; otherwise, <see langword="false"></see>.</returns>
273 <exception cref="T:System.ArgumentNullException"><paramref name="source">source</paramref> is <see langword="null"></see>.</exception>
275 <member name="P:System.Diagnostics.SourceFilter.Source">
276 <summary>Gets or sets the name of the trace source.</summary>
277 <returns>The name of the trace source.</returns>
278 <exception cref="T:System.ArgumentNullException">The value is <see langword="null"></see>.</exception>
280 <member name="T:System.Diagnostics.TraceSwitch">
281 <summary>Provides a multilevel switch to control tracing and debug output without recompiling your code.</summary>
283 <member name="M:System.Diagnostics.TraceSwitch.#ctor(System.String,System.String)">
284 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.TraceSwitch"></see> class, using the specified display name and description.</summary>
285 <param name="displayName">The name to display on a user interface.</param>
286 <param name="description">The description of the switch.</param>
288 <member name="M:System.Diagnostics.TraceSwitch.#ctor(System.String,System.String,System.String)">
289 <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>
290 <param name="displayName">The name to display on a user interface.</param>
291 <param name="description">The description of the switch.</param>
292 <param name="defaultSwitchValue">The default value of the switch.</param>
294 <member name="P:System.Diagnostics.TraceSwitch.Level">
295 <summary>Gets or sets the trace level that determines the messages the switch allows.</summary>
296 <returns>One of the <see cref="T:System.Diagnostics.TraceLevel"></see> values that that specifies the level of messages that are allowed by the switch.</returns>
297 <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>
299 <member name="M:System.Diagnostics.TraceSwitch.OnSwitchSettingChanged">
300 <summary>Updates and corrects the level for this switch.</summary>
302 <member name="M:System.Diagnostics.TraceSwitch.OnValueChanged">
303 <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>
305 <member name="P:System.Diagnostics.TraceSwitch.TraceError">
306 <summary>Gets a value indicating whether the switch allows error-handling messages.</summary>
307 <returns><see langword="true"></see> if the <see cref="P:System.Diagnostics.TraceSwitch.Level"></see> property is set to <see cref="F:System.Diagnostics.TraceLevel.Error"></see>, <see cref="F:System.Diagnostics.TraceLevel.Warning"></see>, <see cref="F:System.Diagnostics.TraceLevel.Info"></see>, or <see cref="F:System.Diagnostics.TraceLevel.Verbose"></see>; otherwise, <see langword="false"></see>.</returns>
309 <member name="P:System.Diagnostics.TraceSwitch.TraceInfo">
310 <summary>Gets a value indicating whether the switch allows informational messages.</summary>
311 <returns><see langword="true"></see> if the <see cref="P:System.Diagnostics.TraceSwitch.Level"></see> property is set to <see cref="F:System.Diagnostics.TraceLevel.Info"></see> or <see cref="F:System.Diagnostics.TraceLevel.Verbose"></see>; otherwise, <see langword="false"></see>.</returns>
313 <member name="P:System.Diagnostics.TraceSwitch.TraceVerbose">
314 <summary>Gets a value indicating whether the switch allows all messages.</summary>
315 <returns><see langword="true"></see> if the <see cref="P:System.Diagnostics.TraceSwitch.Level"></see> property is set to <see cref="F:System.Diagnostics.TraceLevel.Verbose"></see>; otherwise, <see langword="false"></see>.</returns>
317 <member name="P:System.Diagnostics.TraceSwitch.TraceWarning">
318 <summary>Gets a value indicating whether the switch allows warning messages.</summary>
319 <returns><see langword="true"></see> if the <see cref="P:System.Diagnostics.TraceSwitch.Level"></see> property is set to <see cref="F:System.Diagnostics.TraceLevel.Warning"></see>, <see cref="F:System.Diagnostics.TraceLevel.Info"></see>, or <see cref="F:System.Diagnostics.TraceLevel.Verbose"></see>; otherwise, <see langword="false"></see>.</returns>
321 <member name="T:System.Diagnostics.TraceSource">
322 <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>
324 <member name="M:System.Diagnostics.TraceSource.#ctor(System.String)">
325 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.TraceSource"></see> class, using the specified name for the source.</summary>
326 <param name="name">The name of the source (typically, the name of the application).</param>
327 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
328 <exception cref="T:System.ArgumentException"><paramref name="name">name</paramref> is an empty string (&quot;&quot;).</exception>
330 <member name="M:System.Diagnostics.TraceSource.#ctor(System.String,System.Diagnostics.SourceLevels)">
331 <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>
332 <param name="name">The name of the source, typically the name of the application.</param>
333 <param name="defaultLevel">A bitwise combination of the enumeration values that specifies the default source level at which to trace.</param>
334 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is <see langword="null"></see>.</exception>
335 <exception cref="T:System.ArgumentException"><paramref name="name">name</paramref> is an empty string (&quot;&quot;).</exception>
337 <member name="P:System.Diagnostics.TraceSource.Attributes">
338 <summary>Gets the custom switch attributes defined in the application configuration file.</summary>
339 <returns>A <see cref="T:System.Collections.Specialized.StringDictionary"></see> containing the custom attributes for the trace switch.</returns>
341 <member name="M:System.Diagnostics.TraceSource.Close">
342 <summary>Closes all the trace listeners in the trace listener collection.</summary>
344 <member name="M:System.Diagnostics.TraceSource.Flush">
345 <summary>Flushes all the trace listeners in the trace listener collection.</summary>
346 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
348 <member name="M:System.Diagnostics.TraceSource.GetSupportedAttributes">
349 <summary>Gets the custom attributes supported by the trace source.</summary>
350 <returns>A string array naming the custom attributes supported by the trace source, or <see langword="null"></see> if there are no custom attributes.</returns>
352 <member name="P:System.Diagnostics.TraceSource.Listeners">
353 <summary>Gets the collection of trace listeners for the trace source.</summary>
354 <returns>A <see cref="T:System.Diagnostics.TraceListenerCollection"></see> that contains the active trace listeners associated with the source.</returns>
356 <member name="P:System.Diagnostics.TraceSource.Name">
357 <summary>Gets the name of the trace source.</summary>
358 <returns>The name of the trace source.</returns>
360 <member name="P:System.Diagnostics.TraceSource.Switch">
361 <summary>Gets or sets the source switch value.</summary>
362 <returns>A <see cref="T:System.Diagnostics.SourceSwitch"></see> object representing the source switch value.</returns>
363 <exception cref="T:System.ArgumentNullException"><see cref="System.Diagnostics.TraceSource.Switch"></see> is set to <see langword="null"></see>.</exception>
365 <member name="M:System.Diagnostics.TraceSource.TraceData(System.Diagnostics.TraceEventType,System.Int32,System.Object)">
366 <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>
367 <param name="eventType">One of the enumeration values that specifies the event type of the trace data.</param>
368 <param name="id">A numeric identifier for the event.</param>
369 <param name="data">The trace data.</param>
370 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
372 <member name="M:System.Diagnostics.TraceSource.TraceData(System.Diagnostics.TraceEventType,System.Int32,System.Object[])">
373 <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>
374 <param name="eventType">One of the enumeration values that specifies the event type of the trace data.</param>
375 <param name="id">A numeric identifier for the event.</param>
376 <param name="data">An object array containing the trace data.</param>
377 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
379 <member name="M:System.Diagnostics.TraceSource.TraceEvent(System.Diagnostics.TraceEventType,System.Int32)">
380 <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>
381 <param name="eventType">One of the enumeration values that specifies the event type of the trace data.</param>
382 <param name="id">A numeric identifier for the event.</param>
383 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
385 <member name="M:System.Diagnostics.TraceSource.TraceEvent(System.Diagnostics.TraceEventType,System.Int32,System.String)">
386 <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>
387 <param name="eventType">One of the enumeration values that specifies the event type of the trace data.</param>
388 <param name="id">A numeric identifier for the event.</param>
389 <param name="message">The trace message to write.</param>
390 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
392 <member name="M:System.Diagnostics.TraceSource.TraceEvent(System.Diagnostics.TraceEventType,System.Int32,System.String,System.Object[])">
393 <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>
394 <param name="eventType">One of the enumeration values that specifies the event type of the trace data.</param>
395 <param name="id">A numeric identifier for the event.</param>
396 <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>
397 <param name="args">An <see langword="object"></see> array containing zero or more objects to format.</param>
398 <exception cref="T:System.ArgumentNullException"><paramref name="format">format</paramref> is <see langword="null"></see>.</exception>
399 <exception cref="T:System.FormatException"><paramref name="format">format</paramref> is invalid.
401 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>
402 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
404 <member name="M:System.Diagnostics.TraceSource.TraceInformation(System.String)">
405 <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>
406 <param name="message">The informative message to write.</param>
407 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
409 <member name="M:System.Diagnostics.TraceSource.TraceInformation(System.String,System.Object[])">
410 <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>
411 <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>
412 <param name="args">An array containing zero or more objects to format.</param>
413 <exception cref="T:System.ArgumentNullException"><paramref name="format">format</paramref> is <see langword="null"></see>.</exception>
414 <exception cref="T:System.FormatException"><paramref name="format">format</paramref> is invalid.
416 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>
417 <exception cref="T:System.ObjectDisposedException">An attempt was made to trace an event during finalization.</exception>
419 <member name="M:System.Diagnostics.TraceSource.TraceTransfer(System.Int32,System.String,System.Guid)">
420 <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>
421 <param name="id">A numeric identifier for the event.</param>
422 <param name="message">The trace message to write.</param>
423 <param name="relatedActivityId">A structure that identifies the related activity.</param>
425 <member name="T:System.Diagnostics.TraceOptions">
426 <summary>Specifies trace data options to be written to the trace output.</summary>
428 <member name="F:System.Diagnostics.TraceOptions.Callstack">
429 <summary>Write the call stack, which is represented by the return value of the <see cref="P:System.Environment.StackTrace"></see> property.</summary>
432 <member name="F:System.Diagnostics.TraceOptions.DateTime">
433 <summary>Write the date and time.</summary>
436 <member name="F:System.Diagnostics.TraceOptions.LogicalOperationStack">
437 <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>
440 <member name="F:System.Diagnostics.TraceOptions.None">
441 <summary>Do not write any elements.</summary>
444 <member name="F:System.Diagnostics.TraceOptions.ProcessId">
445 <summary>Write the process identity, which is represented by the return value of the <see cref="P:System.Diagnostics.Process.Id"></see> property.</summary>
448 <member name="F:System.Diagnostics.TraceOptions.ThreadId">
449 <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>
452 <member name="F:System.Diagnostics.TraceOptions.Timestamp">
453 <summary>Write the timestamp, which is represented by the return value of the <see cref="M:System.Diagnostics.Stopwatch.GetTimestamp"></see> method.</summary>
456 <member name="T:System.Diagnostics.TraceListenerCollection">
457 <summary>Provides a thread-safe list of <see cref="T:System.Diagnostics.TraceListener"></see> objects.</summary>
459 <member name="M:System.Diagnostics.TraceListenerCollection.Add(System.Diagnostics.TraceListener)">
460 <summary>Adds a <see cref="T:System.Diagnostics.TraceListener"></see> to the list.</summary>
461 <param name="listener">A <see cref="T:System.Diagnostics.TraceListener"></see> to add to the list.</param>
462 <returns>The position at which the new listener was inserted.</returns>
464 <member name="M:System.Diagnostics.TraceListenerCollection.AddRange(System.Diagnostics.TraceListener[])">
465 <summary>Adds an array of <see cref="T:System.Diagnostics.TraceListener"></see> objects to the list.</summary>
466 <param name="value">An array of <see cref="T:System.Diagnostics.TraceListener"></see> objects to add to the list.</param>
467 <exception cref="T:System.ArgumentNullException"><paramref name="value">value</paramref> is <see langword="null"></see>.</exception>
469 <member name="M:System.Diagnostics.TraceListenerCollection.AddRange(System.Diagnostics.TraceListenerCollection)">
470 <summary>Adds the contents of another <see cref="T:System.Diagnostics.TraceListenerCollection"></see> to the list.</summary>
471 <param name="value">Another <see cref="T:System.Diagnostics.TraceListenerCollection"></see> whose contents are added to the list.</param>
472 <exception cref="T:System.ArgumentNullException"><paramref name="value">value</paramref> is <see langword="null"></see>.</exception>
474 <member name="M:System.Diagnostics.TraceListenerCollection.Clear">
475 <summary>Clears all the listeners from the list.</summary>
477 <member name="M:System.Diagnostics.TraceListenerCollection.Contains(System.Diagnostics.TraceListener)">
478 <summary>Checks whether the list contains the specified listener.</summary>
479 <param name="listener">A <see cref="T:System.Diagnostics.TraceListener"></see> to find in the list.</param>
480 <returns><see langword="true"></see> if the listener is in the list; otherwise, <see langword="false"></see>.</returns>
482 <member name="M:System.Diagnostics.TraceListenerCollection.CopyTo(System.Diagnostics.TraceListener[],System.Int32)">
483 <summary>Copies a section of the current <see cref="T:System.Diagnostics.TraceListenerCollection"></see> list to the specified array at the specified index.</summary>
484 <param name="listeners">An array of type <see cref="T:System.Array"></see> to copy the elements into.</param>
485 <param name="index">The starting index number in the current list to copy from.</param>
487 <member name="P:System.Diagnostics.TraceListenerCollection.Count">
488 <summary>Gets the number of listeners in the list.</summary>
489 <returns>The number of listeners in the list.</returns>
491 <member name="M:System.Diagnostics.TraceListenerCollection.GetEnumerator">
492 <summary>Gets an enumerator for this list.</summary>
493 <returns>An enumerator of type <see cref="T:System.Collections.IEnumerator"></see>.</returns>
495 <member name="M:System.Diagnostics.TraceListenerCollection.IndexOf(System.Diagnostics.TraceListener)">
496 <summary>Gets the index of the specified listener.</summary>
497 <param name="listener">A <see cref="T:System.Diagnostics.TraceListener"></see> to find in the list.</param>
498 <returns>The index of the listener, if it can be found in the list; otherwise, -1.</returns>
500 <member name="M:System.Diagnostics.TraceListenerCollection.Insert(System.Int32,System.Diagnostics.TraceListener)">
501 <summary>Inserts the listener at the specified index.</summary>
502 <param name="index">The position in the list to insert the new <see cref="T:System.Diagnostics.TraceListener"></see>.</param>
503 <param name="listener">A <see cref="T:System.Diagnostics.TraceListener"></see> to insert in the list.</param>
504 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="index">index</paramref> is not a valid index in the list.</exception>
505 <exception cref="T:System.ArgumentException"><paramref name="listener">listener</paramref> is <see langword="null"></see>.</exception>
507 <member name="P:System.Diagnostics.TraceListenerCollection.Item(System.Int32)">
508 <summary>Gets or sets the <see cref="T:System.Diagnostics.TraceListener"></see> at the specified index.</summary>
509 <param name="i">The zero-based index of the <see cref="T:System.Diagnostics.TraceListener"></see> to get from the list.</param>
510 <returns>A <see cref="T:System.Diagnostics.TraceListener"></see> with the specified index.</returns>
511 <exception cref="T:System.ArgumentNullException">The value is <see langword="null"></see>.</exception>
513 <member name="P:System.Diagnostics.TraceListenerCollection.Item(System.String)">
514 <summary>Gets the first <see cref="T:System.Diagnostics.TraceListener"></see> in the list with the specified name.</summary>
515 <param name="name">The name of the <see cref="T:System.Diagnostics.TraceListener"></see> to get from the list.</param>
516 <returns>The first <see cref="T:System.Diagnostics.TraceListener"></see> in the list with the given <see cref="P:System.Diagnostics.TraceListener.Name"></see>. This item returns <see langword="null"></see> if no <see cref="T:System.Diagnostics.TraceListener"></see> with the given name can be found.</returns>
518 <member name="M:System.Diagnostics.TraceListenerCollection.Remove(System.String)">
519 <summary>Removes from the collection the first <see cref="T:System.Diagnostics.TraceListener"></see> with the specified name.</summary>
520 <param name="name">The name of the <see cref="T:System.Diagnostics.TraceListener"></see> to remove from the list.</param>
522 <member name="M:System.Diagnostics.TraceListenerCollection.Remove(System.Diagnostics.TraceListener)">
523 <summary>Removes from the collection the specified <see cref="T:System.Diagnostics.TraceListener"></see>.</summary>
524 <param name="listener">A <see cref="T:System.Diagnostics.TraceListener"></see> to remove from the list.</param>
526 <member name="M:System.Diagnostics.TraceListenerCollection.RemoveAt(System.Int32)">
527 <summary>Removes from the collection the <see cref="T:System.Diagnostics.TraceListener"></see> at the specified index.</summary>
528 <param name="index">The zero-based index of the <see cref="T:System.Diagnostics.TraceListener"></see> to remove from the list.</param>
529 <exception cref="T:System.ArgumentOutOfRangeException">The <paramref name="index">index</paramref> is not a valid index in the list.</exception>
531 <member name="M:System.Diagnostics.TraceListenerCollection.System#Collections#ICollection#CopyTo(System.Array,System.Int32)">
532 <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>
533 <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>
534 <param name="index">The zero-based index in array at which copying begins.</param>
536 <member name="P:System.Diagnostics.TraceListenerCollection.System#Collections#ICollection#IsSynchronized">
537 <summary>Gets a value indicating whether access to the <see cref="T:System.Diagnostics.TraceListenerCollection"></see> is synchronized (thread safe).</summary>
538 <returns>Always <see langword="true"></see>.</returns>
540 <member name="P:System.Diagnostics.TraceListenerCollection.System#Collections#ICollection#SyncRoot">
541 <summary>Gets an object that can be used to synchronize access to the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</summary>
542 <returns>The current <see cref="T:System.Diagnostics.TraceListenerCollection"></see> object.</returns>
544 <member name="M:System.Diagnostics.TraceListenerCollection.System#Collections#IList#Add(System.Object)">
545 <summary>Adds a trace listener to the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</summary>
546 <param name="value">The object to add to the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</param>
547 <returns>The position into which the new trace listener was inserted.</returns>
548 <exception cref="T:System.ArgumentException"><paramref name="value">value</paramref> is <see langword="null"></see>.
550 <paramref name="value">value</paramref> is not a <see cref="System.Diagnostics.TraceListener"></see>.</exception>
552 <member name="M:System.Diagnostics.TraceListenerCollection.System#Collections#IList#Contains(System.Object)">
553 <summary>Determines whether the <see cref="T:System.Diagnostics.TraceListenerCollection"></see> contains a specific object.</summary>
554 <param name="value">The object to locate in the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</param>
555 <returns><see langword="true"></see> if the <see cref="T:System.Object"></see> is found in the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>; otherwise, <see langword="false"></see>.</returns>
557 <member name="M:System.Diagnostics.TraceListenerCollection.System#Collections#IList#IndexOf(System.Object)">
558 <summary>Determines the index of a specific object in the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</summary>
559 <param name="value">The object to locate in the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</param>
560 <returns>The index of <paramref name="value">value</paramref> if found in the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>; otherwise, -1.</returns>
562 <member name="M:System.Diagnostics.TraceListenerCollection.System#Collections#IList#Insert(System.Int32,System.Object)">
563 <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>
564 <param name="index">The zero-based index at which value should be inserted.</param>
565 <param name="value">The <see cref="T:System.Diagnostics.TraceListener"></see> object to insert into the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</param>
566 <exception cref="T:System.ArgumentException"><paramref name="value">value</paramref> is not a <see cref="System.Diagnostics.TraceListener"></see> object.</exception>
568 <member name="P:System.Diagnostics.TraceListenerCollection.System#Collections#IList#IsFixedSize">
569 <summary>Gets a value indicating whether the <see cref="T:System.Diagnostics.TraceListenerCollection"></see> has a fixed size.</summary>
570 <returns>Always <see langword="false"></see>.</returns>
572 <member name="P:System.Diagnostics.TraceListenerCollection.System#Collections#IList#IsReadOnly">
573 <summary>Gets a value indicating whether the <see cref="T:System.Diagnostics.TraceListenerCollection"></see> is read-only</summary>
574 <returns>Always <see langword="false"></see>.</returns>
576 <member name="P:System.Diagnostics.TraceListenerCollection.System#Collections#IList#Item(System.Int32)">
577 <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>
578 <param name="index">The zero-based index of the value to get.</param>
579 <returns>The <see cref="T:System.Diagnostics.TraceListener"></see> at the specified index.</returns>
581 <member name="M:System.Diagnostics.TraceListenerCollection.System#Collections#IList#Remove(System.Object)">
582 <summary>Removes an object from the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</summary>
583 <param name="value">The object to remove from the <see cref="T:System.Diagnostics.TraceListenerCollection"></see>.</param>
585 <member name="T:System.Diagnostics.TraceListener">
586 <summary>Provides the <see langword="abstract"></see> base class for the listeners who monitor trace and debug output.</summary>
588 <member name="M:System.Diagnostics.TraceListener.#ctor">
589 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.TraceListener"></see> class.</summary>
591 <member name="M:System.Diagnostics.TraceListener.#ctor(System.String)">
592 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.TraceListener"></see> class using the specified name as the listener.</summary>
593 <param name="name">The name of the <see cref="T:System.Diagnostics.TraceListener"></see>.</param>
595 <member name="P:System.Diagnostics.TraceListener.Attributes">
596 <summary>Gets the custom trace listener attributes defined in the application configuration file.</summary>
597 <returns>A <see cref="T:System.Collections.Specialized.StringDictionary"></see> containing the custom attributes for the trace listener.</returns>
599 <member name="M:System.Diagnostics.TraceListener.Close">
600 <summary>When overridden in a derived class, closes the output stream so it no longer receives tracing or debugging output.</summary>
602 <member name="M:System.Diagnostics.TraceListener.Dispose">
603 <summary>Releases all resources used by the <see cref="T:System.Diagnostics.TraceListener"></see>.</summary>
605 <member name="M:System.Diagnostics.TraceListener.Dispose(System.Boolean)">
606 <summary>Releases the unmanaged resources used by the <see cref="T:System.Diagnostics.TraceListener"></see> and optionally releases the managed resources.</summary>
607 <param name="disposing"><see langword="true"></see> to release both managed and unmanaged resources; <see langword="false"></see> to release only unmanaged resources.</param>
609 <member name="M:System.Diagnostics.TraceListener.Fail(System.String)">
610 <summary>Emits an error message to the listener you create when you implement the <see cref="T:System.Diagnostics.TraceListener"></see> class.</summary>
611 <param name="message">A message to emit.</param>
613 <member name="M:System.Diagnostics.TraceListener.Fail(System.String,System.String)">
614 <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>
615 <param name="message">A message to emit.</param>
616 <param name="detailMessage">A detailed message to emit.</param>
618 <member name="P:System.Diagnostics.TraceListener.Filter">
619 <summary>Gets and sets the trace filter for the trace listener.</summary>
620 <returns>An object derived from the <see cref="T:System.Diagnostics.TraceFilter"></see> base class.</returns>
622 <member name="M:System.Diagnostics.TraceListener.Flush">
623 <summary>When overridden in a derived class, flushes the output buffer.</summary>
625 <member name="M:System.Diagnostics.TraceListener.GetSupportedAttributes">
626 <summary>Gets the custom attributes supported by the trace listener.</summary>
627 <returns>A string array naming the custom attributes supported by the trace listener, or <see langword="null"></see> if there are no custom attributes.</returns>
629 <member name="P:System.Diagnostics.TraceListener.IndentLevel">
630 <summary>Gets or sets the indent level.</summary>
631 <returns>The indent level. The default is zero.</returns>
633 <member name="P:System.Diagnostics.TraceListener.IndentSize">
634 <summary>Gets or sets the number of spaces in an indent.</summary>
635 <returns>The number of spaces in an indent. The default is four spaces.</returns>
636 <exception cref="T:System.ArgumentOutOfRangeException">Set operation failed because the value is less than zero.</exception>
638 <member name="P:System.Diagnostics.TraceListener.IsThreadSafe">
639 <summary>Gets a value indicating whether the trace listener is thread safe.</summary>
640 <returns><see langword="true"></see> if the trace listener is thread safe; otherwise, <see langword="false"></see>. The default is <see langword="false"></see>.</returns>
642 <member name="P:System.Diagnostics.TraceListener.Name">
643 <summary>Gets or sets a name for this <see cref="T:System.Diagnostics.TraceListener"></see>.</summary>
644 <returns>A name for this <see cref="T:System.Diagnostics.TraceListener"></see>. The default is an empty string (&quot;&quot;).</returns>
646 <member name="P:System.Diagnostics.TraceListener.NeedIndent">
647 <summary>Gets or sets a value indicating whether to indent the output.</summary>
648 <returns><see langword="true"></see> if the output should be indented; otherwise, <see langword="false"></see>.</returns>
650 <member name="M:System.Diagnostics.TraceListener.TraceData(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.Object)">
651 <summary>Writes trace information, a data object and event information to the listener specific output.</summary>
652 <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>
653 <param name="source">A name used to identify the output, typically the name of the application that generated the trace event.</param>
654 <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>
655 <param name="id">A numeric identifier for the event.</param>
656 <param name="data">The trace data to emit.</param>
658 <member name="M:System.Diagnostics.TraceListener.TraceData(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.Object[])">
659 <summary>Writes trace information, an array of data objects and event information to the listener specific output.</summary>
660 <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>
661 <param name="source">A name used to identify the output, typically the name of the application that generated the trace event.</param>
662 <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>
663 <param name="id">A numeric identifier for the event.</param>
664 <param name="data">An array of objects to emit as data.</param>
666 <member name="M:System.Diagnostics.TraceListener.TraceEvent(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32)">
667 <summary>Writes trace and event information to the listener specific output.</summary>
668 <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>
669 <param name="source">A name used to identify the output, typically the name of the application that generated the trace event.</param>
670 <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>
671 <param name="id">A numeric identifier for the event.</param>
673 <member name="M:System.Diagnostics.TraceListener.TraceEvent(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.String)">
674 <summary>Writes trace information, a message, and event information to the listener specific output.</summary>
675 <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>
676 <param name="source">A name used to identify the output, typically the name of the application that generated the trace event.</param>
677 <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>
678 <param name="id">A numeric identifier for the event.</param>
679 <param name="message">A message to write.</param>
681 <member name="M:System.Diagnostics.TraceListener.TraceEvent(System.Diagnostics.TraceEventCache,System.String,System.Diagnostics.TraceEventType,System.Int32,System.String,System.Object[])">
682 <summary>Writes trace information, a formatted array of objects and event information to the listener specific output.</summary>
683 <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>
684 <param name="source">A name used to identify the output, typically the name of the application that generated the trace event.</param>
685 <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>
686 <param name="id">A numeric identifier for the event.</param>
687 <param name="format">A format string that contains zero or more format items, which correspond to objects in the args array.</param>
688 <param name="args">An <see langword="object"></see> array containing zero or more objects to format.</param>
690 <member name="P:System.Diagnostics.TraceListener.TraceOutputOptions">
691 <summary>Gets or sets the trace output options.</summary>
692 <returns>A bitwise combination of the enumeration values. The default is <see cref="F:System.Diagnostics.TraceOptions.None"></see>.</returns>
693 <exception cref="T:System.ArgumentOutOfRangeException">Set operation failed because the value is invalid.</exception>
695 <member name="M:System.Diagnostics.TraceListener.TraceTransfer(System.Diagnostics.TraceEventCache,System.String,System.Int32,System.String,System.Guid)">
696 <summary>Writes trace information, a message, a related activity identity and event information to the listener specific output.</summary>
697 <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>
698 <param name="source">A name used to identify the output, typically the name of the application that generated the trace event.</param>
699 <param name="id">A numeric identifier for the event.</param>
700 <param name="message">A message to write.</param>
701 <param name="relatedActivityId">A <see cref="T:System.Guid"></see> object identifying a related activity.</param>
703 <member name="M:System.Diagnostics.TraceListener.Write(System.Object)">
704 <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>
705 <param name="o">An <see cref="T:System.Object"></see> whose fully qualified class name you want to write.</param>
707 <member name="M:System.Diagnostics.TraceListener.Write(System.String)">
708 <summary>When overridden in a derived class, writes the specified message to the listener you create in the derived class.</summary>
709 <param name="message">A message to write.</param>
711 <member name="M:System.Diagnostics.TraceListener.Write(System.Object,System.String)">
712 <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>
713 <param name="o">An <see cref="T:System.Object"></see> whose fully qualified class name you want to write.</param>
714 <param name="category">A category name used to organize the output.</param>
716 <member name="M:System.Diagnostics.TraceListener.Write(System.String,System.String)">
717 <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>
718 <param name="message">A message to write.</param>
719 <param name="category">A category name used to organize the output.</param>
721 <member name="M:System.Diagnostics.TraceListener.WriteIndent">
722 <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 <see langword="false"></see>.</summary>
724 <member name="M:System.Diagnostics.TraceListener.WriteLine(System.Object)">
725 <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>
726 <param name="o">An <see cref="T:System.Object"></see> whose fully qualified class name you want to write.</param>
728 <member name="M:System.Diagnostics.TraceListener.WriteLine(System.String)">
729 <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>
730 <param name="message">A message to write.</param>
732 <member name="M:System.Diagnostics.TraceListener.WriteLine(System.Object,System.String)">
733 <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>
734 <param name="o">An <see cref="T:System.Object"></see> whose fully qualified class name you want to write.</param>
735 <param name="category">A category name used to organize the output.</param>
737 <member name="M:System.Diagnostics.TraceListener.WriteLine(System.String,System.String)">
738 <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>
739 <param name="message">A message to write.</param>
740 <param name="category">A category name used to organize the output.</param>
742 <member name="T:System.Diagnostics.TraceLevel">
743 <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>
745 <member name="F:System.Diagnostics.TraceLevel.Error">
746 <summary>Output error-handling messages.</summary>
749 <member name="F:System.Diagnostics.TraceLevel.Info">
750 <summary>Output informational messages, warnings, and error-handling messages.</summary>
753 <member name="F:System.Diagnostics.TraceLevel.Off">
754 <summary>Output no tracing and debugging messages.</summary>
757 <member name="F:System.Diagnostics.TraceLevel.Verbose">
758 <summary>Output all debugging and tracing messages.</summary>
761 <member name="F:System.Diagnostics.TraceLevel.Warning">
762 <summary>Output warnings and error-handling messages.</summary>
765 <member name="T:System.Diagnostics.TraceFilter">
766 <summary>Provides the base class for trace filter implementations.</summary>
768 <member name="M:System.Diagnostics.TraceFilter.#ctor">
769 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.TraceFilter"></see> class.</summary>
771 <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[])">
772 <summary>When overridden in a derived class, determines whether the trace listener should trace the event.</summary>
773 <param name="cache">The <see cref="T:System.Diagnostics.TraceEventCache"></see> that contains information for the trace event.</param>
774 <param name="source">The name of the source.</param>
775 <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>
776 <param name="id">A trace identifier number.</param>
777 <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>
778 <param name="args">An array of argument objects.</param>
779 <param name="data1">A trace data object.</param>
780 <param name="data">An array of trace data objects.</param>
781 <returns><see langword="true"></see> to trace the specified event; otherwise, <see langword="false"></see>.</returns>
783 <member name="T:System.Diagnostics.TraceEventType">
784 <summary>Identifies the type of event that has caused the trace.</summary>
786 <member name="F:System.Diagnostics.TraceEventType.Critical">
787 <summary>Fatal error or application crash.</summary>
790 <member name="F:System.Diagnostics.TraceEventType.Error">
791 <summary>Recoverable error.</summary>
794 <member name="F:System.Diagnostics.TraceEventType.Information">
795 <summary>Informational message.</summary>
798 <member name="F:System.Diagnostics.TraceEventType.Resume">
799 <summary>Resumption of a logical operation.</summary>
802 <member name="F:System.Diagnostics.TraceEventType.Start">
803 <summary>Starting of a logical operation.</summary>
806 <member name="F:System.Diagnostics.TraceEventType.Stop">
807 <summary>Stopping of a logical operation.</summary>
810 <member name="F:System.Diagnostics.TraceEventType.Suspend">
811 <summary>Suspension of a logical operation.</summary>
814 <member name="F:System.Diagnostics.TraceEventType.Transfer">
815 <summary>Changing of correlation identity.</summary>
818 <member name="F:System.Diagnostics.TraceEventType.Verbose">
819 <summary>Debugging trace.</summary>
822 <member name="F:System.Diagnostics.TraceEventType.Warning">
823 <summary>Noncritical problem.</summary>
826 <member name="T:System.Diagnostics.TraceEventCache">
827 <summary>Provides trace event data specific to a thread and a process.</summary>
829 <member name="M:System.Diagnostics.TraceEventCache.#ctor">
830 <summary>Initializes a new instance of the <see cref="T:System.Diagnostics.TraceEventCache"></see> class.</summary>
832 <member name="P:System.Diagnostics.TraceEventCache.Callstack">
833 <summary>Gets the call stack for the current thread.</summary>
834 <returns>A string containing stack trace information. This value can be an empty string (&quot;&quot;).</returns>
836 <member name="P:System.Diagnostics.TraceEventCache.DateTime">
837 <summary>Gets the date and time at which the event trace occurred.</summary>
838 <returns>A <see cref="T:System.DateTime"></see> structure whose value is a date and time expressed in Coordinated Universal Time (UTC).</returns>
840 <member name="P:System.Diagnostics.TraceEventCache.LogicalOperationStack">
841 <summary>Gets the correlation data, contained in a stack.</summary>
842 <returns>A <see cref="T:System.Collections.Stack"></see> containing correlation data.</returns>
844 <member name="P:System.Diagnostics.TraceEventCache.ProcessId">
845 <summary>Gets the unique identifier of the current process.</summary>
846 <returns>The system-generated unique identifier of the current process.</returns>
848 <member name="P:System.Diagnostics.TraceEventCache.ThreadId">
849 <summary>Gets a unique identifier for the current managed thread.</summary>
850 <returns>A string that represents a unique integer identifier for this managed thread.</returns>
852 <member name="P:System.Diagnostics.TraceEventCache.Timestamp">
853 <summary>Gets the current number of ticks in the timer mechanism.</summary>
854 <returns>The tick counter value of the underlying timer mechanism.</returns>
856 <member name="T:System.Diagnostics.Trace">
857 <summary>Provides a set of methods and properties that help you trace the execution of your code. This class cannot be inherited.</summary>
859 <member name="M:System.Diagnostics.Trace.Assert(System.Boolean)">
860 <summary>Checks for a condition; if the condition is <see langword="false"></see>, displays a message box that shows the call stack.</summary>
861 <param name="condition">The conditional expression to evaluate. If the condition is <see langword="true"></see>, a failure message is not sent and the message box is not displayed.</param>
863 <member name="M:System.Diagnostics.Trace.Assert(System.Boolean,System.String)">
864 <summary>Checks for a condition; if the condition is <see langword="false"></see>, outputs a specified message and displays a message box that shows the call stack.</summary>
865 <param name="condition">The conditional expression to evaluate. If the condition is <see langword="true"></see>, the specified message is not sent and the message box is not displayed.</param>
866 <param name="message">The message to send to the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</param>
868 <member name="M:System.Diagnostics.Trace.Assert(System.Boolean,System.String,System.String)">
869 <summary>Checks for a condition; if the condition is <see langword="false"></see>, outputs two specified messages and displays a message box that shows the call stack.</summary>
870 <param name="condition">The conditional expression to evaluate. If the condition is <see langword="true"></see>, the specified messages are not sent and the message box is not displayed.</param>
871 <param name="message">The message to send to the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</param>
872 <param name="detailMessage">The detailed message to send to the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</param>
874 <member name="P:System.Diagnostics.Trace.AutoFlush">
875 <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>
876 <returns><see langword="true"></see> if <see cref="M:System.Diagnostics.Trace.Flush"></see> is called on the <see cref="P:System.Diagnostics.Trace.Listeners"></see> after every write; otherwise, <see langword="false"></see>.</returns>
878 <member name="M:System.Diagnostics.Trace.Close">
879 <summary>Flushes the output buffer, and then closes the <see cref="P:System.Diagnostics.Trace.Listeners"></see>.</summary>
881 <member name="P:System.Diagnostics.Trace.CorrelationManager">
882 <summary>Gets the correlation manager for the thread for this trace.</summary>
883 <returns>The <see cref="T:System.Diagnostics.CorrelationManager"></see> object associated with the thread for this trace.</returns>
885 <member name="M:System.Diagnostics.Trace.Fail(System.String)">
886 <summary>Emits the specified error message.</summary>
887 <param name="message">A message to emit.</param>
889 <member name="M:System.Diagnostics.Trace.Fail(System.String,System.String)">
890 <summary>Emits an error message, and a detailed error message.</summary>
891 <param name="message">A message to emit.</param>
892 <param name="detailMessage">A detailed message to emit.</param>
894 <member name="M:System.Diagnostics.Trace.Flush">
895 <summary>Flushes the output buffer, and causes buffered data to be written to the <see cref="P:System.Diagnostics.Trace.Listeners"></see>.</summary>
897 <member name="M:System.Diagnostics.Trace.Indent">
898 <summary>Increases the current <see cref="P:System.Diagnostics.Trace.IndentLevel"></see> by one.</summary>
900 <member name="P:System.Diagnostics.Trace.IndentLevel">
901 <summary>Gets or sets the indent level.</summary>
902 <returns>The indent level. The default is zero.</returns>
904 <member name="P:System.Diagnostics.Trace.IndentSize">
905 <summary>Gets or sets the number of spaces in an indent.</summary>
906 <returns>The number of spaces in an indent. The default is four.</returns>
908 <member name="P:System.Diagnostics.Trace.Listeners">
909 <summary>Gets the collection of listeners that is monitoring the trace output.</summary>
910 <returns>A <see cref="T:System.Diagnostics.TraceListenerCollection"></see> that represents a collection of type <see cref="T:System.Diagnostics.TraceListener"></see> monitoring the trace output.</returns>
912 <member name="M:System.Diagnostics.Trace.Refresh">
913 <summary>Refreshes the trace configuration data.</summary>
915 <member name="M:System.Diagnostics.Trace.TraceError(System.String)">
916 <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>
917 <param name="message">The informative message to write.</param>
919 <member name="M:System.Diagnostics.Trace.TraceError(System.String,System.Object[])">
920 <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>
921 <param name="format">A format string that contains zero or more format items, which correspond to objects in the args array.</param>
922 <param name="args">An <see langword="object"></see> array containing zero or more objects to format.</param>
924 <member name="M:System.Diagnostics.Trace.TraceInformation(System.String)">
925 <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>
926 <param name="message">The informative message to write.</param>
928 <member name="M:System.Diagnostics.Trace.TraceInformation(System.String,System.Object[])">
929 <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>
930 <param name="format">A format string that contains zero or more format items, which correspond to objects in the args array.</param>
931 <param name="args">An <see langword="object"></see> array containing zero or more objects to format.</param>
933 <member name="M:System.Diagnostics.Trace.TraceWarning(System.String,System.Object[])">
934 <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>
935 <param name="format">A format string that contains zero or more format items, which correspond to objects in the args array.</param>
936 <param name="args">An <see langword="object"></see> array containing zero or more objects to format.</param>
938 <member name="M:System.Diagnostics.Trace.TraceWarning(System.String)">
939 <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>
940 <param name="message">The informative message to write.</param>
942 <member name="M:System.Diagnostics.Trace.Unindent">
943 <summary>Decreases the current <see cref="P:System.Diagnostics.Trace.IndentLevel"></see> by one.</summary>
945 <member name="P:System.Diagnostics.Trace.UseGlobalLock">
946 <summary>Gets or sets a value indicating whether the global lock should be used.</summary>
947 <returns><see langword="true"></see> if the global lock is to be used; otherwise, <see langword="false"></see>. The default is <see langword="true"></see>.</returns>
949 <member name="M:System.Diagnostics.Trace.Write(System.Object)">
950 <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>
951 <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>
953 <member name="M:System.Diagnostics.Trace.Write(System.String)">
954 <summary>Writes a message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</summary>
955 <param name="message">A message to write.</param>
957 <member name="M:System.Diagnostics.Trace.Write(System.Object,System.String)">
958 <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>
959 <param name="value">An <see cref="T:System.Object"></see> name is sent to the <see cref="P:System.Diagnostics.Trace.Listeners"></see>.</param>
960 <param name="category">A category name used to organize the output.</param>
962 <member name="M:System.Diagnostics.Trace.Write(System.String,System.String)">
963 <summary>Writes a category name and a message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</summary>
964 <param name="message">A message to write.</param>
965 <param name="category">A category name used to organize the output.</param>
967 <member name="M:System.Diagnostics.Trace.WriteIf(System.Boolean,System.String,System.String)">
968 <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 <see langword="true"></see>.</summary>
969 <param name="condition"><see langword="true"></see> to cause a message to be written; otherwise, <see langword="false"></see>.</param>
970 <param name="message">A message to write.</param>
971 <param name="category">A category name used to organize the output.</param>
973 <member name="M:System.Diagnostics.Trace.WriteIf(System.Boolean,System.Object,System.String)">
974 <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 <see langword="true"></see>.</summary>
975 <param name="condition"><see langword="true"></see> to cause a message to be written; otherwise, <see langword="false"></see>.</param>
976 <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>
977 <param name="category">A category name used to organize the output.</param>
979 <member name="M:System.Diagnostics.Trace.WriteIf(System.Boolean,System.Object)">
980 <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 <see langword="true"></see>.</summary>
981 <param name="condition"><see langword="true"></see> to cause a message to be written; otherwise, <see langword="false"></see>.</param>
982 <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>
984 <member name="M:System.Diagnostics.Trace.WriteIf(System.Boolean,System.String)">
985 <summary>Writes a message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection if a condition is <see langword="true"></see>.</summary>
986 <param name="condition"><see langword="true"></see> to cause a message to be written; otherwise, <see langword="false"></see>.</param>
987 <param name="message">A message to write.</param>
989 <member name="M:System.Diagnostics.Trace.WriteLine(System.Object)">
990 <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>
991 <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>
993 <member name="M:System.Diagnostics.Trace.WriteLine(System.String)">
994 <summary>Writes a message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</summary>
995 <param name="message">A message to write.</param>
997 <member name="M:System.Diagnostics.Trace.WriteLine(System.Object,System.String)">
998 <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>
999 <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>
1000 <param name="category">A category name used to organize the output.</param>
1002 <member name="M:System.Diagnostics.Trace.WriteLine(System.String,System.String)">
1003 <summary>Writes a category name and message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection.</summary>
1004 <param name="message">A message to write.</param>
1005 <param name="category">A category name used to organize the output.</param>
1007 <member name="M:System.Diagnostics.Trace.WriteLineIf(System.Boolean,System.Object,System.String)">
1008 <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 <see langword="true"></see>.</summary>
1009 <param name="condition"><see langword="true"></see> to cause a message to be written; otherwise, <see langword="false"></see>.</param>
1010 <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>
1011 <param name="category">A category name used to organize the output.</param>
1013 <member name="M:System.Diagnostics.Trace.WriteLineIf(System.Boolean,System.Object)">
1014 <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 <see langword="true"></see>.</summary>
1015 <param name="condition"><see langword="true"></see> to cause a message to be written; otherwise, <see langword="false"></see>.</param>
1016 <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>
1018 <member name="M:System.Diagnostics.Trace.WriteLineIf(System.Boolean,System.String)">
1019 <summary>Writes a message to the trace listeners in the <see cref="P:System.Diagnostics.Trace.Listeners"></see> collection if a condition is <see langword="true"></see>.</summary>
1020 <param name="condition"><see langword="true"></see> to cause a message to be written; otherwise, <see langword="false"></see>.</param>
1021 <param name="message">A message to write.</param>
1023 <member name="M:System.Diagnostics.Trace.WriteLineIf(System.Boolean,System.String,System.String)">
1024 <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 <see langword="true"></see>.</summary>
1025 <param name="condition"><see langword="true"></see> to cause a message to be written; otherwise, <see langword="false"></see>.</param>
1026 <param name="message">A message to write.</param>
1027 <param name="category">A category name used to organize the output.</param>