TraceSource.TraceData Método

Definición

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 -> unit
Public 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[] -> unit
Public 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.

Se aplica a