TraceSource.TraceData Método

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Grava dados de rastreamento nos ouvintes de rastreamento na coleção Listeners.

Sobrecargas

TraceData(TraceEventType, Int32, Object)	Grava dados de rastreamento para os ouvintes de rastreamento na coleção Listeners usando o tipo de evento, o identificador de evento e os dados de rastreamento especificados.
TraceData(TraceEventType, Int32, Object[])	Grava dados de rastreamento nos ouvintes de rastreamento na coleção Listeners usando o tipo de evento, o identificador de evento e a matriz de dados de rastreamento especificados.

TraceData(TraceEventType, Int32, Object)

Origem:

TraceSource.cs

Grava dados de rastreamento para os ouvintes de rastreamento na coleção Listeners usando o tipo de evento, o identificador de evento e os dados de rastreamento 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")>]
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

Um dos valores de enumeração que especifica o tipo de evento dos dados de rastreamento.

id

Int32

Um identificador numérico do evento.

data

Object

Os dados de rastreamento.

Atributos

ConditionalAttribute

Exceções

ObjectDisposedException

Foi feita uma tentativa de rastrear um evento durante a finalização.

Exemplos

O exemplo de código a seguir mostra o uso do TraceData(TraceEventType, Int32, Object) método para filtrar e encaminhar uma mensagem de rastreamento para os ouvintes. Este exemplo de código faz parte de um exemplo maior fornecido para a TraceSource classe .

// 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.")

Comentários

O TraceData método, como o TraceEvent método , destina-se a ferramentas automatizadas, mas também permite a anexação de um objeto adicional, como uma instância de exceção, ao rastreamento.

O TraceData método chama o SourceSwitch.ShouldTrace método do SourceSwitch objeto retornado pela Switch propriedade . Se ShouldTrace retornar true, TraceData chamará o método correspondente TraceData em todos os ouvintes. Caso contrário, TraceData retornará sem chamar os métodos dos ouvintes.

Observação

O EventLogTraceListener objeto é limitado a um valor máximo id de 65.535. Se o id valor especificado for maior que 65.535, o EventLogTraceListener objeto usará 65.535.

TraceData(TraceEventType, Int32, Object[])

Origem:

TraceSource.cs

Grava dados de rastreamento nos ouvintes de rastreamento na coleção Listeners usando o tipo de evento, o identificador de evento e a matriz de dados de rastreamento 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")>]
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

Um dos valores de enumeração que especifica o tipo de evento dos dados de rastreamento.

id

Int32

Um identificador numérico do evento.

data

Object[]

Uma matriz de objeto que contém os dados de rastreamento.

Atributos

ConditionalAttribute

Exceções

ObjectDisposedException

Foi feita uma tentativa de rastrear um evento durante a finalização.

Comentários

O TraceData método, como o TraceEvent método , destina-se a ferramentas automatizadas, mas também permite a anexação de objetos adicionais, como uma instância de exceção e um rastreamento de pilha, ao rastreamento.

O TraceData método chama o ShouldTrace método do SourceSwitch objeto retornado pela Switch propriedade . Se ShouldTrace retornar true, TraceData chamará o método correspondente TraceData em todos os ouvintes. Caso contrário, TraceData retornará sem chamar os métodos dos ouvintes.

Observação

O EventLogTraceListener objeto é limitado a um valor máximo id de 65.535. Se o id valor especificado for maior que 65.535, o EventLogTraceListener objeto usará 65.535.