EventSchemaTraceListener.TraceData Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Writes trace data to the log file.
Overloads
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Writes trace information, a single data object, and event information to the log file. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Writes trace information, multiple data objects, and event information to the log file. |
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)
Writes trace information, a single data object, and event information to the log file.
public:
override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);[System.Security.SecurityCritical]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object data);[<System.Security.SecurityCritical>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unitPublic Overrides Sub TraceData (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, data As Object)Parameters
- eventCache
- TraceEventCache
A TraceEventCache that contains the current process ID, thread ID, and stack trace information.
- source
- String
The source name.
- eventType
- TraceEventType
One of the TraceEventType values.
- id
- Int32
A numeric identifier for the event.
- data
- Object
A data object to emit.
- Attributes
Remarks
The eventCache, source, eventType, and id parameters are used in the header and footer of the trace. The id parameter is converted to an unsigned integer before it is written. Therefore, a negative id value is written as a large positive integer. The data parameter is written as a Data node in the UserData element. The ToString method of the data object is used to convert the object to a string.
Important
This method is not intended to be called directly by application code. It is called by methods of the Debug, Trace, and TraceSource classes to write trace data.
Applies to
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])
Writes trace information, multiple data objects, and event information to the log file.
public:
override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);[System.Security.SecurityCritical]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object[] data);[<System.Security.SecurityCritical>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unitPublic Overrides Sub TraceData (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, ParamArray data As Object())Parameters
- eventCache
- TraceEventCache
A TraceEventCache that contains the current process ID, thread ID, and stack trace information.
- source
- String
The source name.
- eventType
- TraceEventType
One of the TraceEventType values.
- id
- Int32
A numeric identifier for the event.
- data
- Object[]
An array of data objects to emit.
- Attributes
Remarks
The eventCache, source, eventType, and id parameters are used in the header and footer of the trace. The id parameter is converted to an unsigned integer before it is written. Therefore, a negative id value is written as a large positive integer. The objects in the data parameter array are written as Data nodes in the UserData element. The ToString method of each data object is used to convert the object to a string.
Important
This method is not intended to be called directly by application code. It is called by methods of the Debug, Trace, and TraceSource classes to write trace data.
