EventLogTraceListener.TraceEvent Método

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.EventLog.dll

Paquete:

System.Diagnostics.EventLog v8.0.0

Escribe la información de seguimiento en el registro de eventos.

Sobrecargas

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Escribe la información de seguimiento, un mensaje y la información de evento en el registro de eventos.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Escribe la información de seguimiento, una matriz de objetos con formato y la información de evento en el registro de eventos.

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

Source:

EventLogTraceListener.cs

Escribe la información de seguimiento, un mensaje y la información de evento en el registro 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

Objeto que contiene el identificador de proceso actual, el identificador de subproceso e información sobre el seguimiento de la pila.

source

String

Nombre usado para identificar el resultado; normalmente es el nombre de la aplicación que generó el evento de seguimiento.

severity

TraceEventType

Uno de los valores de enumeración que especifica el tipo de evento que ha causado el seguimiento.

id

Int32

Identificador numérico para el evento. La combinación de source e id identifica de manera única un evento.

message

String

Mensaje de seguimiento.

Atributos

ComVisibleAttribute

Excepciones

ArgumentException

source no se especifica.

o bien

La cadena de entrada de registro supera 32.766 caracteres.

Comentarios

Importante

El TraceEvent código de la aplicación no está diseñado para llamar a los métodos. Los métodos de las Debugclases , Tracey TraceSource llaman a estos métodos para escribir datos de seguimiento.

El TraceEvent método está diseñado para realizar un seguimiento de eventos que las herramientas pueden procesar automáticamente. Por ejemplo, una herramienta de supervisión puede notificar a un administrador si un origen específico realiza un seguimiento de un evento específico.

Los eventCache parámetros y source se usan para determinar si se debe realizar un seguimiento del evento. id se usa para crear un EventInstance objeto y se TraceEventType equivale a para EventLogEntryType la EntryType propiedad . EventInstance se escribe en el registro de eventos con los message datos mediante el WriteEvent método .

Nota

El valor máximo del id parámetro es 65 535. Si el id valor especificado es mayor que 65 535, se usa el valor máximo.

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

Source:

EventLogTraceListener.cs

Escribe la información de seguimiento, una matriz de objetos con formato y la información de evento en el registro 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

Objeto que contiene el identificador de proceso actual, el identificador de subproceso e información sobre el seguimiento de la pila.

source

String

Nombre usado para identificar el resultado; normalmente es el nombre de la aplicación que generó el evento de seguimiento.

severity

TraceEventType

Uno de los valores de enumeración que especifica el tipo de evento que ha causado el seguimiento.

id

Int32

Identificador numérico para el evento. La combinación de source e id identifica de manera única un evento.

format

String

Cadena de formato que contiene cero o más elementos de formato que corresponden a los objetos de la matriz args.

args

Object[]

Matriz de object que contiene cero o más objetos a los que se va a aplicar formato.

Atributos

ComVisibleAttribute

Excepciones

ArgumentException

source no se especifica.

o bien

La cadena de entrada de registro supera 32.766 caracteres.

Comentarios

Importante

El TraceEvent código de la aplicación no está diseñado para llamar a los métodos. Los métodos de las Debugclases , Tracey TraceSource llaman a estos métodos para escribir datos de seguimiento.

El TraceEvent método está diseñado para realizar un seguimiento de eventos que las herramientas pueden procesar automáticamente. Por ejemplo, una herramienta de supervisión puede notificar a un administrador si un origen específico realiza un seguimiento de un evento específico.

Los eventCache parámetros y source se usan para determinar si se debe realizar un seguimiento del evento. id se usa para crear un EventInstance objeto y se TraceEventType equivale a para EventLogEntryType la EntryType propiedad . EventInstance se escribe en el registro de eventos, mediante el WriteEvent método , con el mensaje obtenido de los format parámetros y args . La args matriz de objetos se convierte en una cadena mediante el Format método , pasando la format cadena y args la matriz para dar formato a la cadena como mensaje para el registro de eventos.

Nota

El valor máximo del id parámetro es 65 535. Si el id valor especificado es mayor que 65 535, se usa el valor máximo.