TraceSource.TraceData Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Escribe datos de seguimiento en los agentes de escucha de seguimiento de la colección Listeners.
Sobrecargas
| TraceData(TraceEventType, Int32, Object) |
Escribe datos de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y los datos de seguimiento especificados. |
| TraceData(TraceEventType, Int32, Object[]) |
Escribe datos de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y la matriz de datos de seguimiento especificados. |
TraceData(TraceEventType, Int32, Object)
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
Escribe datos de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y los datos de seguimiento especificados.
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 -> unitPublic Sub TraceData (eventType As TraceEventType, id As Integer, data As Object)Parámetros
- eventType
- TraceEventType
Uno de los valores de enumeración que especifica el tipo de evento de los datos de seguimiento.
- id
- Int32
Identificador numérico para el evento.
- data
- Object
Datos de seguimiento.
- Atributos
Excepciones
Se ha intentado realizar la traza de un evento durante la finalización.
Ejemplos
En el TraceData(TraceEventType, Int32, Object) ejemplo de código siguiente se muestra el uso del método para filtrar y reenviar un mensaje de seguimiento a los agentes de escucha. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase TraceSource.
// 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.")
Comentarios
El TraceData método, como el TraceEvent método , está pensado para herramientas automatizadas, pero también permite la asociación de un objeto adicional, como una instancia de excepción, al seguimiento.
El TraceData método llama al SourceSwitch.ShouldTrace método del SourceSwitch objeto devuelto por la Switch propiedad . Si ShouldTrace devuelve true, TraceData llama al método correspondiente TraceData en todos los agentes de escucha. De lo contrario, TraceData devuelve sin llamar a los métodos de los agentes de escucha.
Nota
El EventLogTraceListener objeto se limita a un valor máximo id de 65 535. Si el id valor especificado es mayor que 65 535, el EventLogTraceListener objeto usa 65 535.
Se aplica a
TraceData(TraceEventType, Int32, Object[])
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
Escribe datos de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y la matriz de datos de seguimiento especificados.
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[] -> unitPublic Sub TraceData (eventType As TraceEventType, id As Integer, ParamArray data As Object())Parámetros
- eventType
- TraceEventType
Uno de los valores de enumeración que especifica el tipo de evento de los datos de seguimiento.
- id
- Int32
Identificador numérico para el evento.
- data
- Object[]
Matriz de objetos que contiene los datos de seguimiento.
- Atributos
Excepciones
Se ha intentado realizar la traza de un evento durante la finalización.
Comentarios
El TraceData método, como el TraceEvent método , está pensado para herramientas automatizadas, pero también permite la asociación de objetos adicionales, como una instancia de excepción y un seguimiento de pila, al seguimiento.
El TraceData método llama al ShouldTrace método del SourceSwitch objeto devuelto por la Switch propiedad . Si ShouldTrace devuelve true, TraceData llama al método correspondiente TraceData en todos los agentes de escucha. De lo contrario, TraceData devuelve sin llamar a los métodos de los agentes de escucha.
Nota
El EventLogTraceListener objeto se limita a un valor máximo id de 65 535. Si el id valor especificado es mayor que 65 535, el EventLogTraceListener objeto usa 65 535.
