TraceListener::TraceEvent Method (TraceEventCache^, String^, TraceEventType, Int32, String^, array<Object^>^)
Writes trace information, a formatted array of objects and event information to the listener specific output.
Assembly: System (in System.dll)
public: [ComVisibleAttribute(false)] virtual void TraceEvent( TraceEventCache^ eventCache, String^ source, TraceEventType eventType, int id, String^ format, ... array<Object^>^ args )
Parameters
- eventCache
-
Type:
System.Diagnostics::TraceEventCache^
A TraceEventCache object that contains the current process ID, thread ID, and stack trace information.
- source
-
Type:
System::String^
A name used to identify the output, typically the name of the application that generated the trace event.
- eventType
-
Type:
System.Diagnostics::TraceEventType
One of the TraceEventType values specifying the type of event that has caused the trace.
- id
-
Type:
System::Int32
A numeric identifier for the event.
- format
-
Type:
System::String^
A format string that contains zero or more format items, which correspond to objects in the args array.
- args
-
Type:
array<System::Object^>^
An object array containing zero or more objects to format.
Important |
|---|
This method is not intended to be called directly by application code but by members of the Debug, Trace, and TraceSource classes to write trace data to output. |
The default implementation writes the values of the source, eventType and id parameters as a header. The args object array is converted to a string using the Format method, passing the format string and args array to format the string as the message portion of the trace. The eventCache data is written as a footer, the nature of the output data being dependent on the value of the TraceOutputOptions property.
Available since 2.0
