Compartilhar via


EventLogTraceListener.TraceEvent Método

Definição

Grava informações de rastreamento de evento no log de evento.

Sobrecargas

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Grava informações de rastreamento, uma mensagem e informações de evento no log de eventos.

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

Grava informações de rastreamento, uma matriz de objetos formatados e informações de evento no log de eventos.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Origem:
EventLogTraceListener.cs
Origem:
EventLogTraceListener.cs
Origem:
EventLogTraceListener.cs

Grava informações de rastreamento, uma mensagem e informações de evento no log de eventos.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ message);
[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string message);
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, message As String)

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.

message
String

A mensagem de rastreamento.

Atributos

Exceções

source não está especificado.

- ou -

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

Comentários

Importante

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

O TraceEvent método destina-se a rastrear eventos que podem ser processados automaticamente por ferramentas. Por exemplo, uma ferramenta de monitoramento poderá notificar um administrador se um evento específico for rastreado por uma fonte específica.

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 os message dados 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.

Aplica-se a

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

Origem:
EventLogTraceListener.cs
Origem:
EventLogTraceListener.cs
Origem:
EventLogTraceListener.cs

Grava informações de rastreamento, uma matriz de objetos formatados e informações de evento no log de eventos.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);
[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string format, params object[] args);
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, format As String, ParamArray args 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.

format
String

Uma cadeia de caracteres de formato que contém zero ou mais itens de formato, que correspondem aos objetos na matriz args.

args
Object[]

Uma matriz object que contém zero ou mais objetos a serem formatados.

Atributos

Exceções

source não está especificado.

- ou -

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

Comentários

Importante

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

O TraceEvent método destina-se a rastrear eventos que podem ser processados automaticamente por ferramentas. Por exemplo, uma ferramenta de monitoramento poderá notificar um administrador se um evento específico for rastreado por uma fonte específica.

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, usando o WriteEvent método , com a mensagem obtida dos format parâmetros e args . A args matriz de objetos é convertida em uma cadeia de caracteres usando o Format método , passando a format cadeia de caracteres e args a matriz para formatar a cadeia de caracteres como a mensagem para o log de eventos.

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.

Aplica-se a