EventLogTraceListener.TraceData Método

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Pacote:

System.Diagnostics.EventLog v8.0.0

Grava dados de rastreamento no log de eventos.

Sobrecargas

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Grava as informações de rastreamento, um objeto de dados e informações de evento no log de eventos.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Grava as informações de rastreamento, uma matriz de objetos de dados e informações de evento para o log de evento.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Origem:

EventLogTraceListener.cs

Grava as informações de rastreamento, um objeto de dados e informações de evento no log de eventos.

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::Object ^ data);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, object data);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, data As Object)

Parâmetros

eventCache

TraceEventCache

Um objeto que contém as informações atuais de ID de processo, ID de thread e rastreamento de pilha.

source

String

Um nome usado para identificar a saída, geralmente o nome do aplicativo que gerou o evento de rastreamento.

severity

TraceEventType

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

id

Int32

Um identificador numérico do evento. A combinação de source e id identifica um evento de maneira exclusiva.

data

Object

O objeto de dados a ser gravado no fluxo ou arquivo de saída.

Atributos

ComVisibleAttribute

Exceções

ArgumentException

source não está especificado.

- ou -

A cadeia de caracteres de entrada de log excede 32.766 caracteres.

Comentários

Importante

Os TraceData métodos não devem ser chamados pelo código do aplicativo. Eles são chamados por métodos das Debugclasses , Tracee TraceSource para gerar dados de rastreamento.

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

Os eventCache parâmetros e source são usados para determinar se o evento deve ser rastreado. id é usado para criar um EventInstance objeto e o TraceEventType é equivalente a um EventLogEntryType para a EntryType propriedade . O EventInstance é gravado no log de eventos com o data objeto , formatado como uma cadeia de caracteres, usando o WriteEvent método .

Observação

O valor máximo do id parâmetro é 65.535. Se o id valor especificado for maior que 65.535, o valor máximo será usado.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Origem:

EventLogTraceListener.cs

Grava as informações de rastreamento, uma matriz de objetos de dados e informações de evento para o log de evento.

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, ... cli::array <System::Object ^> ^ data);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, params object[] data);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, ParamArray data As Object())

Parâmetros

eventCache

TraceEventCache

Um objeto que contém as informações atuais de ID de processo, ID de thread e rastreamento de pilha.

source

String

Um nome usado para identificar a saída, geralmente o nome do aplicativo que gerou o evento de rastreamento.

severity

TraceEventType

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

id

Int32

Um identificador numérico do evento. A combinação de source e id identifica um evento de maneira exclusiva.

data

Object[]

Uma matriz de objetos de dados.

Atributos

ComVisibleAttribute

Exceções

ArgumentException

source não está especificado.

- ou -

A cadeia de caracteres de entrada de log excede 32.766 caracteres.

Comentários

Importante

Os TraceData métodos não devem ser chamados pelo código do aplicativo. Eles são chamados por métodos das Debugclasses , Tracee TraceSource para gerar dados de rastreamento.

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

Os severity dados de parâmetro e id são usados para criar um EventInstance objeto, que é gravado no log de eventos com os dados da matriz de objetos de dados.

Os eventCache parâmetros e source são usados para determinar se o evento deve ser rastreado. id é usado para criar um EventInstance objeto e o TraceEventType é equivalente a um EventLogEntryType para a EntryType propriedade . O EventInstance é gravado no log de eventos com a data matriz de objetos, formatada como uma matriz de cadeia de caracteres, usando o WriteEvent método .

Observação

O valor máximo do id parâmetro é 65.535. Se o id valor especificado for maior que 65.535, o valor máximo será usado.