TraceSource.TraceEvent Method (TraceEventType, Int32, String, Object())
Writes a trace event to the trace listeners in the Listeners collection using the specified event type, event identifier, and argument array and format.
Assembly: System (in System.dll)
<ConditionalAttribute("TRACE")> Public Sub TraceEvent ( eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object() )
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 args array.
An object array containing zero or more objects to format.
format is null.
format is invalid.
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.
For more information about the format parameter, see Composite Formatting.
Themethod is intended to trace events that can be processed automatically by tools. For example, a monitoring tool can notify an administrator if a specific event is traced by a specific source.
The ShouldTrace method of the SourceSwitch object returned by the Switch property. If ShouldTrace returns true, calls the corresponding TraceEvent method of each listener. Otherwise, returns without calling the listeners' methods.method calls the
The trace content is listener specific. The default TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object()) method writes the source name, event type, and numeric identity in the trace header, then calls the String.Format(IFormatProvider, String, Object()) method, passing the format string and args array and using the CultureInfo.InvariantCulture property to format the string as the message output.
The following code example shows the use of the TraceEvent(TraceEventType, Int32) method to pass a trace event to the listeners. This code example is part of a larger example provided for the TraceSource class.
Available since 2.0