TraceSource.TraceData Método

Definição

Espaço de Nomes:
System.Diagnostics
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

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 -> 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 rastreio.

id
Int32

Um identificador numérico para o evento.

data
Object

Os dados de rasto.

Atributos
ConditionalAttribute

Exceções

ObjectDisposedException

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[] -> 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 rastreio.

id
Int32

Um identificador numérico para o evento.

data
Object[]

Um array de objetos contendo os dados de traço.

Atributos
ConditionalAttribute

Exceções

ObjectDisposedException

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.

Aplica-se a