XmlWriterTraceListener.TraceData Method
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 output file or stream.
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Writes trace information, a data object, and event information to the file or stream. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Writes trace information, data objects, and event information to the file or stream. |
- Source:
- XmlWriterTraceListener.cs
- Source:
- XmlWriterTraceListener.cs
- Source:
- XmlWriterTraceListener.cs
Writes trace information, a data object, and event information to the file or stream.
public:
override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);public override void TraceData(System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object? data);public override void TraceData(System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object data);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.
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 writing, so a negative id value is written as a large positive integer. The data parameter is written as a DataItem node in the TraceData 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
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
- Source:
- XmlWriterTraceListener.cs
- Source:
- XmlWriterTraceListener.cs
- Source:
- XmlWriterTraceListener.cs
Writes trace information, data objects, and event information to the file or stream.
public:
override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);public override void TraceData(System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object?[]? data);public override void TraceData(System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object[] data);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.
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 writing, so a negative id value is written as a large positive integer. The objects in the data parameter array are written as DataItem nodes in the TraceData 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.
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: