TraceSource.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 trace listeners in the Listeners collection.
TraceData(TraceEventType, Int32, Object) |
Writes trace data to the trace listeners in the Listeners collection using the specified event type, event identifier, and trace data. |
TraceData(TraceEventType, Int32, Object[]) |
Writes trace data to the trace listeners in the Listeners collection using the specified event type, event identifier, and trace data array. |
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
Writes trace data to the trace listeners in the Listeners collection using the specified event type, event identifier, and trace data.
public:
void TraceData(System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);
[System.Diagnostics.Conditional("TRACE")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, object? data);
[System.Diagnostics.Conditional("TRACE")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, object data);
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj -> unit
Public Sub TraceData (eventType As TraceEventType, id As Integer, data As Object)
Parameters
- eventType
- TraceEventType
One of the enumeration values that specifies the event type of the trace data.
- id
- Int32
A numeric identifier for the event.
- data
- Object
The trace data.
- Attributes
Exceptions
An attempt was made to trace an event during finalization.
Examples
The following code example shows the use of the TraceData(TraceEventType, Int32, Object) method to filter and forward a trace message to the listeners. This code example is part of a larger example provided for the TraceSource class.
// Test the filter on the ConsoleTraceListener.
ts.Listeners["console"].Filter = new SourceFilter("No match");
ts.TraceData(TraceEventType.Error, 5,
"SourceFilter should reject this message for the console trace listener.");
ts.Listeners["console"].Filter = new SourceFilter("TraceTest");
ts.TraceData(TraceEventType.Error, 6,
"SourceFilter should let this message through on the console trace listener.");
' Test the filter on the ConsoleTraceListener.
ts.Listeners("console").Filter = New SourceFilter("No match")
ts.TraceData(TraceEventType.Error, 5, "SourceFilter should reject this message for the console trace listener.")
ts.Listeners("console").Filter = New SourceFilter("TraceTest")
ts.TraceData(TraceEventType.Error, 6, "SourceFilter should let this message through on the console trace listener.")
Remarks
The TraceData method, like the TraceEvent method, is intended for automated tools, but it also allows the attaching of an additional object, such as an exception instance, to the trace.
The TraceData method calls the SourceSwitch.ShouldTrace method of the SourceSwitch object returned by the Switch property. If ShouldTrace returns true
, TraceData calls the corresponding TraceData method on all listeners. Otherwise, TraceData returns without calling the listeners' methods.
Note
The EventLogTraceListener object is limited to a maximum id
value of 65,535. If the id
value specified is greater than 65,535, the EventLogTraceListener object uses 65,535.
Applies to
.NET 9 and other versions
Product | Versions |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.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 Standard | 2.0, 2.1 |
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
Writes trace data to the trace listeners in the Listeners collection using the specified event type, event identifier, and trace data array.
public:
void TraceData(System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);
[System.Diagnostics.Conditional("TRACE")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, params object?[]? data);
[System.Diagnostics.Conditional("TRACE")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, params object[] data);
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj[] -> unit
Public Sub TraceData (eventType As TraceEventType, id As Integer, ParamArray data As Object())
Parameters
- eventType
- TraceEventType
One of the enumeration values that specifies the event type of the trace data.
- id
- Int32
A numeric identifier for the event.
- data
- Object[]
An object array containing the trace data.
- Attributes
Exceptions
An attempt was made to trace an event during finalization.
Remarks
The TraceData method, like the TraceEvent method, is intended for automated tools, but it also allows the attaching of additional objects, such as an exception instance and a stack trace, to the trace.
The TraceData method calls the ShouldTrace method of the SourceSwitch object returned by the Switch property. If ShouldTrace returns true
, TraceData calls the corresponding TraceData method on all listeners. Otherwise, TraceData returns without calling the listeners' methods.
Note
The EventLogTraceListener object is limited to a maximum id
value of 65,535. If the id
value specified is greater than 65,535, the EventLogTraceListener object uses 65,535.
Applies to
.NET 9 and other versions
Product | Versions |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.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 Standard | 2.0, 2.1 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: