TraceSource.TraceData Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Escreve dados de rastreamento para os ouvintes de rastreio na Listeners coleção.
Sobrecargas
| Name | Description |
|---|---|
| TraceData(TraceEventType, Int32, Object) |
Escreve dados de rastreio para os ouvintes de rastreio na Listeners coleção usando o tipo de evento especificado, identificador de evento e dados de rastreio. |
| TraceData(TraceEventType, Int32, Object[]) |
Escreve dados de rastreio para os ouvintes de rastreio na Listeners coleção usando o tipo de evento especificado, identificador de evento e array de dados de traço. |
TraceData(TraceEventType, Int32, Object)
Escreve dados de rastreio para os ouvintes de rastreio na Listeners coleção usando o tipo de evento especificado, identificador de evento e dados de rastreio.
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 -> 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 rastreio.
- id
- Int32
Um identificador numérico para o evento.
- data
- Object
Os dados de rasto.
- Atributos
Exceções
Foi feita uma tentativa de rastrear um evento durante a finalização.
Exemplos
O seguinte exemplo de código mostra o uso do TraceData(TraceEventType, Int32, Object) método para filtrar e encaminhar uma mensagem de rastreio 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.")
Observações
O TraceData método, tal 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 rastreio.
O TraceData método chama o SourceSwitch.ShouldTrace método do SourceSwitch objeto devolvido pela Switch propriedade. Se ShouldTrace retorna true, TraceData chama o método correspondente TraceData em todos os ouvintes. Caso contrário, TraceData retorna sem chamar os métodos dos ouvintes.
Note
O EventLogTraceListener objeto está limitado a um valor máximo id de 65.535. Se o id valor especificado for superior a 65.535, o EventLogTraceListener objeto usa 65.535.
Aplica-se a
TraceData(TraceEventType, Int32, Object[])
Escreve dados de rastreio para os ouvintes de rastreio na Listeners coleção usando o tipo de evento especificado, identificador de evento e array de dados de traço.
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[] -> 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 rastreio.
- id
- Int32
Um identificador numérico para o evento.
- data
- Object[]
Um array de objetos contendo os dados de traço.
- Atributos
Exceções
Foi feita uma tentativa de rastrear um evento durante a finalização.
Observações
O TraceData método, tal 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 traço de pilha, ao trilho.
O TraceData método chama o ShouldTrace método do SourceSwitch objeto devolvido pela Switch propriedade. Se ShouldTrace retorna true, TraceData chama o método correspondente TraceData em todos os ouvintes. Caso contrário, TraceData retorna sem chamar os métodos dos ouvintes.
Note
O EventLogTraceListener objeto está limitado a um valor máximo id de 65.535. Se o id valor especificado for superior a 65.535, o EventLogTraceListener objeto usa 65.535.