System.Diagnostics.TraceSource

Provides a simple on/off switch that controls debugging and tracing output.

2

Initializes a new instance of the class with the specified display name and description.

The name to display on a user interface. The description of the switch.

Initializes a new instance of the class with the specified display name, description, and default switch value.

The name to display on the user interface. The description of the switch. The default value of the switch.

Gets or sets a value indicating whether the switch is enabled or disabled.

true if the switch is enabled; otherwise, false. The default is false. The caller does not have the correct permission. 2

Determines whether the new value of the property can be parsed as a Boolean value.

Provides the default output methods and behavior for tracing.

1

Initializes a new instance of the class with "Default" as its property value.

Emits or displays a message and a stack trace for an assertion that always fails.

The message to emit or display. 2

Emits or displays detailed messages and a stack trace for an assertion that always fails.

The message to emit or display. The detailed message to emit or display. 2

Writes the output to the OutputDebugString function and to the method.

The message to write to OutputDebugString and . 2

Writes the output to the OutputDebugString function and to the method, followed by a carriage return and line feed (\r\n).

The message to write to OutputDebugString and . 2

Indicates whether a listener should trace based on the event type.

Initializes a new instance of the class.

A bitwise combination of the values that specifies the event type of the messages to trace.

Gets or sets the event type of the messages to trace.

A bitwise combination of the values.

Determines whether the trace listener should trace the event.

trueif the trace should be produced; otherwise, false. A that represents the information cache for the trace event. The name of the source. One of the values. A trace identifier number. The format to use for writing an array of arguments, or a message to write. An array of argument objects. A trace data object. An array of trace data objects.

Indicates whether a listener should trace a message based on the source of a trace.

2

Initializes a new instance of the class, specifying the name of the trace source.

The name of the trace source.

Determines whether the trace listener should trace the event.

true if the trace should be produced; otherwise, false. An object that represents the information cache for the trace event. The name of the source. One of the enumeration values that identifies the event type. A trace identifier number. The format to use for writing an array of arguments or a message to write. An array of argument objects. A trace data object. An array of trace data objects. is null. 2

Gets or sets the name of the trace source.

The name of the trace source. The value is null. 2

Specifies the levels of trace messages filtered by the source switch and event type filter.

2

Allows all events through.

Allows only events through.

Allows and events through.

Allows , , , and events through.

Does not allow any events through.

Allows , , , , and events through.

Allows , , and events through.

Provides a multilevel switch to control tracing and debug output without recompiling your code.

2

Initializes a new instance of the class, specifying the name of the source.

The name of the source.

Initializes a new instance of the class, specifying the display name and the default value for the source switch.

The name of the source switch. The default value for the switch.

Gets or sets the level of the switch.

One of the values that represents the event level of the switch. 2

Invoked when the value of the property changes.

The new value of is not one of the values.

Determines if trace listeners should be called, based on the trace event type.

True if the trace listeners should be called; otherwise, false. One of the values. 2

Provides an abstract base class to create new debugging and tracing switches.

2

Initializes a new instance of the class.

The name of the switch. The description for the switch.

Initializes a new instance of the class, specifying the display name, description, and default value for the switch.

The name of the switch. The description of the switch. The default value for the switch.

Gets a description of the switch.

The description of the switch. The default value is an empty string (""). 2

Gets a name used to identify the switch.

The name used to identify the switch. The default value is an empty string (""). 2

Invoked when the property is changed.

Invoked when the property is changed.

Gets or sets the current setting for this switch.

The current setting for this switch. The default is zero.

Gets or sets the value of the switch.

A string representing the value of the switch. The value is null.-or-The value does not consist solely of an optional negative sign followed by a sequence of digits ranging from 0 to 9.-or-The value represents a number less than or greater than .

Provides a set of methods and properties that help you trace the execution of your code. This class cannot be inherited.

1

Checks for a condition; if the condition is false, displays a message box that shows the call stack.

The conditional expression to evaluate. If the condition is true, a failure message is not sent and the message box is not displayed. 2

Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

The conditional expression to evaluate. If the condition is true, the specified message is not sent and the message box is not displayed. The message to send to the collection. 2

Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

The conditional expression to evaluate. If the condition is true, the specified messages are not sent and the message box is not displayed. The message to send to the collection. The detailed message to send to the collection. 2

Gets or sets whether should be called on the after every write.

true if is called on the after every write; otherwise, false. 2

Flushes the output buffer, and then closes the .

1

Emits the specified error message.

A message to emit. 2

Emits an error message, and a detailed error message.

A message to emit. A detailed message to emit. 2

Flushes the output buffer, and causes buffered data to be written to the .

1

Increases the current by one.

2

Gets or sets the indent level.

The indent level. The default is zero. 2

Gets or sets the number of spaces in an indent.

The number of spaces in an indent. The default is four. 2

Gets the collection of listeners that is monitoring the trace output.

A that represents a collection of type monitoring the trace output. 1

Refreshes the trace configuration data.

1

Writes an error message to the trace listeners in the collection using the specified message.

The informative message to write. 1

Writes an error message to the trace listeners in the collection using the specified array of objects and formatting information.

A format string that contains zero or more format items, which correspond to objects in the array. An object array containing zero or more objects to format. 1

Writes an informational message to the trace listeners in the collection using the specified message.

The informative message to write. 1

Writes an informational message to the trace listeners in the collection using the specified array of objects and formatting information.

A format string that contains zero or more format items, which correspond to objects in the array. An object array containing zero or more objects to format. 1

Writes a warning message to the trace listeners in the collection using the specified message.

The informative message to write. 1

Writes a warning message to the trace listeners in the collection using the specified array of objects and formatting information.

A format string that contains zero or more format items, which correspond to objects in the array. An object array containing zero or more objects to format. 1

Decreases the current by one.

2

Gets or sets a value indicating whether the global lock should be used.

true if the global lock is to be used; otherwise, false. The default is true.

Writes the value of the object's method to the trace listeners in the collection.

An whose name is sent to the . 1

Writes a category name and the value of the object's method to the trace listeners in the collection.

An name is sent to the . A category name used to organize the output. 1

Writes a message to the trace listeners in the collection.

A message to write. 1

Writes a category name and a message to the trace listeners in the collection.

A message to write. A category name used to organize the output. 1

Writes the value of the object's method to the trace listeners in the collection if a condition is true.

true to cause a message to be written; otherwise, false. An whose name is sent to the . 1

Writes a category name and the value of the object's method to the trace listeners in the collection if a condition is true.

true to cause a message to be written; otherwise, false. An whose name is sent to the . A category name used to organize the output. 1

Writes a message to the trace listeners in the collection if a condition is true.

true to cause a message to be written; otherwise, false. A message to write. 1

Writes a category name and message to the trace listeners in the collection if a condition is true.

true to cause a message to be written; otherwise, false. A message to write. A category name used to organize the output. 1

Writes the value of the object's method to the trace listeners in the collection.

An whose name is sent to the . 1

Writes a category name and the value of the object's method to the trace listeners in the collection.

An whose name is sent to the . A category name used to organize the output. 1

Writes a message to the trace listeners in the collection.

A message to write. 1

Writes a category name and message to the trace listeners in the collection.

A message to write. A category name used to organize the output. 1

Writes the value of the object's method to the trace listeners in the collection if a condition is true.

true to cause a message to be written; otherwise, false. An whose name is sent to the . 1

Writes a category name and the value of the object's method to the trace listeners in the collection if a condition is true.

true to cause a message to be written; otherwise, false. An whose name is sent to the . A category name used to organize the output. 1

Writes a message to the trace listeners in the collection if a condition is true.

true to cause a message to be written; otherwise, false. A message to write. 1

Writes a category name and message to the trace listeners in the collection if a condition is true.

true to cause a message to be written; otherwise, false. A message to write. A category name used to organize the output. 1

Provides trace event data specific to a thread and a process.

2

Initializes a new instance of the class.

Gets the date and time at which the event trace occurred.

A structure whose value is a date and time expressed in Coordinated Universal Time (UTC). 2

Gets the unique identifier of the current process.

The system-generated unique identifier of the current process. 2

Gets a unique identifier for the current managed thread.

A string that represents a unique integer identifier for this managed thread. 2

Gets the current number of ticks in the timer mechanism.

The tick counter value of the underlying timer mechanism. 2

Identifies the type of event that has caused the trace.

2

Fatal error or application crash.

Recoverable error.

Informational message.

Debugging trace.

Noncritical problem.

Provides the base class for trace filter implementations.

2

Initializes a new instance of the class.

When overridden in a derived class, determines whether the trace listener should trace the event.

true to trace the specified event; otherwise, false. The that contains information for the trace event. The name of the source. One of the values specifying the type of event that has caused the trace. A trace identifier number. Either the format to use for writing an array of arguments specified by the parameter, or a message to write. An array of argument objects. A trace data object. An array of trace data objects. 2

Specifies what messages to output for the , and classes.

2

Output error-handling messages.

Output informational messages, warnings, and error-handling messages.

Output no tracing and debugging messages.

Output all debugging and tracing messages.

Output warnings and error-handling messages.

Provides the abstract base class for the listeners who monitor trace and debug output.

2

Initializes a new instance of the class.

Initializes a new instance of the class using the specified name as the listener.

The name of the .

Releases all resources used by the .

2

Releases the unmanaged resources used by the and optionally releases the managed resources.

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Emits an error message to the listener you create when you implement the class.

A message to emit. 2

Emits an error message and a detailed error message to the listener you create when you implement the class.

A message to emit. A detailed message to emit. 2

Gets and sets the trace filter for the trace listener.

An object derived from the base class. 2

When overridden in a derived class, flushes the output buffer.

2

Gets or sets the indent level.

The indent level. The default is zero. 2

Gets or sets the number of spaces in an indent.

The number of spaces in an indent. The default is four spaces. Set operation failed because the value is less than zero. 2

Gets a value indicating whether the trace listener is thread safe.

true if the trace listener is thread safe; otherwise, false. The default is false.

Gets or sets a name for this .

A name for this . The default is an empty string (""). 2

Gets or sets a value indicating whether to indent the output.

true if the output should be indented; otherwise, false.

Writes trace information, a data object and event information to the listener specific output.

A object that contains the current process ID, thread ID, and stack trace information. A name used to identify the output, typically the name of the application that generated the trace event. One of the values specifying the type of event that has caused the trace. A numeric identifier for the event. The trace data to emit. 1

Writes trace information, an array of data objects and event information to the listener specific output.

A object that contains the current process ID, thread ID, and stack trace information. A name used to identify the output, typically the name of the application that generated the trace event. One of the values specifying the type of event that has caused the trace. A numeric identifier for the event. An array of objects to emit as data. 1

Writes trace and event information to the listener specific output.

A object that contains the current process ID, thread ID, and stack trace information. A name used to identify the output, typically the name of the application that generated the trace event. One of the values specifying the type of event that has caused the trace. A numeric identifier for the event. 1

Writes trace information, a message, and event information to the listener specific output.

A object that contains the current process ID, thread ID, and stack trace information. A name used to identify the output, typically the name of the application that generated the trace event. One of the values specifying the type of event that has caused the trace. A numeric identifier for the event. A message to write. 1

Writes trace information, a formatted array of objects and event information to the listener specific output.

A object that contains the current process ID, thread ID, and stack trace information. A name used to identify the output, typically the name of the application that generated the trace event. One of the values specifying the type of event that has caused the trace. A numeric identifier for the event. A format string that contains zero or more format items, which correspond to objects in the array. An object array containing zero or more objects to format. 1

Gets or sets the trace output options.

A bitwise combination of the enumeration values. The default is . Set operation failed because the value is invalid. 2

Writes the value of the object's method to the listener you create when you implement the class.

An whose fully qualified class name you want to write. 2

Writes a category name and the value of the object's method to the listener you create when you implement the class.

An whose fully qualified class name you want to write. A category name used to organize the output. 2

When overridden in a derived class, writes the specified message to the listener you create in the derived class.

A message to write. 2

Writes a category name and a message to the listener you create when you implement the class.

A message to write. A category name used to organize the output. 2

Writes the indent to the listener you create when you implement this class, and resets the property to false.

Writes the value of the object's method to the listener you create when you implement the class, followed by a line terminator.

An whose fully qualified class name you want to write. 2

Writes a category name and the value of the object's method to the listener you create when you implement the class, followed by a line terminator.

An whose fully qualified class name you want to write. A category name used to organize the output. 2

When overridden in a derived class, writes a message to the listener you create in the derived class, followed by a line terminator.

A message to write. 2

Writes a category name and a message to the listener you create when you implement the class, followed by a line terminator.

A message to write. A category name used to organize the output. 2

Provides a thread-safe list of objects.

2

Adds a to the list.

The position at which the new listener was inserted. A to add to the list. 2

Adds an array of objects to the list.

An array of objects to add to the list. is null. 2

Adds the contents of another to the list.

Another whose contents are added to the list. is null. 2

Clears all the listeners from the list.

2

Checks whether the list contains the specified listener.

true if the listener is in the list; otherwise, false. A to find in the list. 2

Copies a section of the current list to the specified array at the specified index.

An array of type to copy the elements into. The starting index number in the current list to copy from. 2

Gets the number of listeners in the list.

The number of listeners in the list. 2

Gets an enumerator for this list.

An enumerator of type . 2

Gets the index of the specified listener.

The index of the listener, if it can be found in the list; otherwise, -1. A to find in the list. 2

Inserts the listener at the specified index.

The position in the list to insert the new . A to insert in the list. The is not a valid index in the list. is null. 2

Gets or sets the at the specified index.

A with the specified index. The zero-based index of the to get from the list. The value is null. 2

Gets the first in the list with the specified name.

The first in the list with the given . This item returns null if no with the given name can be found. The name of the to get from the list. 2

Removes from the collection the specified .

A to remove from the list. 2

Removes from the collection the first with the specified name.

The name of the to remove from the list. 2

Removes from the collection the at the specified index.

The zero-based index of the to remove from the list. The is not a valid index in the list. 2

Copies a section of the current to the specified array of objects.

The one-dimensional array of objects that is the destination of the elements copied from the . The array must have zero-based indexing. The zero-based index in at which copying begins.

Gets a value indicating whether access to the is synchronized (thread safe).

Always true.

Gets an object that can be used to synchronize access to the .

The current object.

Adds a trace listener to the .

The position into which the new trace listener was inserted. The object to add to the . is null. -or- is not a .

Determines whether the contains a specific object.

true if the is found in the ; otherwise, false. The object to locate in the .

Determines the index of a specific object in the .

The index of if found in the ; otherwise, -1. The object to locate in the .

Inserts a object at the specified position in the .

The zero-based index at which should be inserted. The object to insert into the . is not a object.

Gets a value indicating whether the has a fixed size.

Always false.

Gets a value indicating whether the is read-only

Always false.

Gets or sets the at the specified index in the .

The at the specified index. The zero-based index of the to get.

Removes an object from the .

The object to remove from the .

Specifies trace data options to be written to the trace output.

2

Write the date and time.

Do not write any elements.

Write the process identity, which is represented by the return value of the property.

Write the thread identity, which is represented by the return value of the property for the current thread.

Write the timestamp, which is represented by the return value of the method.

Provides a set of methods and properties that enable applications to trace the execution of code and associate trace messages with their source.

1

Initializes a new instance of the class, using the specified name for the source.

The name of the source (typically, the name of the application). is null. is an empty string ("").

Initializes a new instance of the class, using the specified name for the source and the default source level at which tracing is to occur.

The name of the source, typically the name of the application. A bitwise combination of the enumeration values that specifies the default source level at which to trace. is null. is an empty string ("").

Closes all the trace listeners in the trace listener collection.

1

Flushes all the trace listeners in the trace listener collection.

An attempt was made to trace an event during finalization. 1

Gets the collection of trace listeners for the trace source.

A that contains the active trace listeners associated with the source. 1

Gets the name of the trace source.

The name of the trace source. 1

Gets or sets the source switch value.

A object representing the source switch value. is set to null. 1

Writes trace data to the trace listeners in the collection using the specified event type, event identifier, and trace data.

One of the enumeration values that specifies the event type of the trace data. A numeric identifier for the event. The trace data. An attempt was made to trace an event during finalization. 1

Writes trace data to the trace listeners in the collection using the specified event type, event identifier, and trace data array.

One of the enumeration values that specifies the event type of the trace data. A numeric identifier for the event. An object array containing the trace data. An attempt was made to trace an event during finalization. 1

Writes a trace event message to the trace listeners in the collection using the specified event type and event identifier.

One of the enumeration values that specifies the event type of the trace data. A numeric identifier for the event. An attempt was made to trace an event during finalization. 1

Writes a trace event message to the trace listeners in the collection using the specified event type, event identifier, and message.

One of the enumeration values that specifies the event type of the trace data. A numeric identifier for the event. The trace message to write. An attempt was made to trace an event during finalization. 1

Writes a trace event to the trace listeners in the collection using the specified event type, event identifier, and argument array and format.

One of the enumeration values that specifies the event type of the trace data. A numeric identifier for the event. A composite format string (see Remarks) that contains text intermixed with zero or more format items, which correspond to objects in the array. An object array containing zero or more objects to format. is null. is invalid.-or- 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. An attempt was made to trace an event during finalization. 1

Writes an informational message to the trace listeners in the collection using the specified message.

The informative message to write. An attempt was made to trace an event during finalization. 1

Writes an informational message to the trace listeners in the collection using the specified object array and formatting information.

A composite format string (see Remarks) that contains text intermixed with zero or more format items, which correspond to objects in the array. An array containing zero or more objects to format. is null. is invalid.-or- 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. An attempt was made to trace an event during finalization. 1

Provides a multilevel switch to control tracing and debug output without recompiling your code.

2

Initializes a new instance of the class, using the specified display name and description.

The name to display on a user interface. The description of the switch.

Initializes a new instance of the class, using the specified display name, description, and default value for the switch.

The name to display on a user interface. The description of the switch. The default value of the switch.

Gets or sets the trace level that determines the messages the switch allows.

One of the values that that specifies the level of messages that are allowed by the switch. is set to a value that is not one of the values. 1

Updates and corrects the level for this switch.

Sets the property to the integer equivalent of the property.

Gets a value indicating whether the switch allows error-handling messages.

true if the property is set to , , , or ; otherwise, false. 1

Gets a value indicating whether the switch allows informational messages.

true if the property is set to or ; otherwise, false. 1

Gets a value indicating whether the switch allows all messages.

true if the property is set to ; otherwise, false. 1

Gets a value indicating whether the switch allows warning messages.

true if the property is set to , , or ; otherwise, false. 1