EventLogTraceListener.TraceEvent Método

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Pacote:

System.Diagnostics.EventLog v8.0.0

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

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

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

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

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

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