TraceSource.TraceData Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Origem:
- TraceSource.cs
- 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")]
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
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
Exceções
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.
Aplica-se a
TraceData(TraceEventType, Int32, Object[])
- Origem:
- TraceSource.cs
- Origem:
- TraceSource.cs
- 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")]
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
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
Exceções
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.
