EventLogTraceListener.TraceEvent Metodo

Definizione

Scrive le informazioni di traccia di evento nel log eventi.Writes event trace information to the event log.

Overload

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

Scrive le informazioni di traccia, un messaggio e le informazioni di evento nel log eventi.Writes trace information, a message, and event information to the event log.

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

Scrive le informazioni di traccia, una matrice formattata di oggetti e le informazioni di evento nel log eventi.Writes trace information, a formatted array of objects, and event information to the event log.

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

Scrive le informazioni di traccia, un messaggio e le informazioni di evento nel log eventi.Writes trace information, a message, and event information to the event log.

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

Parametri

eventCache
TraceEventCache

Oggetto che contiene l'ID processo corrente, l'ID thread e le informazioni di analisi dello stack.An object that contains the current process ID, thread ID, and stack trace information.

source
String

Nome utilizzato per identificare l'output. In genere corrisponde al nome dell'applicazione che ha generato l'evento di traccia.A name used to identify the output; typically the name of the application that generated the trace event.

severity
TraceEventType

Uno dei valori di enumerazione che specifica il tipo di evento che ha causato la traccia.One of the enumeration values that specifies the type of event that has caused the trace.

id
Int32

Identificatore numerico per l'evento.A numeric identifier for the event. La combinazione di source e id identifica un evento in modo univoco.The combination of source and id uniquely identifies an event.

message
String

Messaggi di traccia.The trace message.

Attributi

Eccezioni

source non specificato.source is not specified.

-oppure--or- La stringa della voce di log supera il limite di 32.766 caratteri.The log entry string exceeds 32,766 characters.

Commenti

Importante

I metodi TraceEvent non sono destinati a essere chiamati dal codice dell'applicazione.The TraceEvent methods are not intended to be called by application code. Questi metodi vengono chiamati dai metodi delle classi Debug, Tracee TraceSource per scrivere i dati di traccia.These methods are called by methods of the Debug, Trace, and TraceSource classes to write trace data.

Il metodo TraceEvent è progettato per tracciare gli eventi che possono essere elaborati automaticamente dagli strumenti.The TraceEvent method is intended to trace events that can be processed automatically by tools. Uno strumento di monitoraggio, ad esempio, può notificare a un amministratore se un evento specifico viene tracciato da un'origine specifica.For example a monitoring tool can notify an administrator if a specific event is traced by a specific source.

Per determinare se l'evento deve essere tracciato, vengono utilizzati i parametri eventCache e source.The eventCache and source parameters are used to determine if the event should be traced. id viene utilizzato per creare un oggetto EventInstance e il TraceEventType è equiparato a un EventLogEntryType per la proprietà EntryType.id is used to create an EventInstance object and the TraceEventType is equated to an EventLogEntryType for the EntryType property. Il EventInstance viene scritto nel registro eventi con i dati message utilizzando il metodo WriteEvent.The EventInstance is written to the event log with the message data using the WriteEvent method.

Nota

Il valore massimo del parametro id è 65.535.The maximum value of the id parameter is 65,535. Se il valore id specificato è maggiore di 65.535, viene utilizzato il valore massimo.If the id value specified is greater than 65,535, the maximum value is used.

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

Scrive le informazioni di traccia, una matrice formattata di oggetti e le informazioni di evento nel log eventi.Writes trace information, a formatted array of objects, and event information to the event log.

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

Parametri

eventCache
TraceEventCache

Oggetto che contiene l'ID processo corrente, l'ID thread e le informazioni di analisi dello stack.An object that contains the current process ID, thread ID, and stack trace information.

source
String

Nome utilizzato per identificare l'output. In genere corrisponde al nome dell'applicazione che ha generato l'evento di traccia.A name used to identify the output; typically the name of the application that generated the trace event.

severity
TraceEventType

Uno dei valori di enumerazione che specifica il tipo di evento che ha causato la traccia.One of the enumeration values that specifies the type of event that has caused the trace.

id
Int32

Identificatore numerico per l'evento.A numeric identifier for the event. La combinazione di source e id identifica un evento in modo univoco.The combination of source and id uniquely identifies an event.

format
String

Stringa di formato che contiene zero o più elementi di formato, corrispondenti a oggetti nella matrice args.A format string that contains zero or more format items that correspond to objects in the args array.

args
Object[]

Matrice object che contiene zero o più oggetti da formattare.An object array containing zero or more objects to format.

Attributi

Eccezioni

source non specificato.source is not specified.

-oppure--or- La stringa della voce di log supera il limite di 32.766 caratteri.The log entry string exceeds 32,766 characters.

Commenti

Importante

I metodi TraceEvent non sono destinati a essere chiamati dal codice dell'applicazione.The TraceEvent methods are not intended to be called by application code. Questi metodi vengono chiamati dai metodi delle classi Debug, Tracee TraceSource per scrivere i dati di traccia.These methods are called by methods of the Debug, Trace, and TraceSource classes to write trace data.

Il metodo TraceEvent è progettato per tracciare gli eventi che possono essere elaborati automaticamente dagli strumenti.The TraceEvent method is intended to trace events that can be processed automatically by tools. Uno strumento di monitoraggio, ad esempio, può notificare a un amministratore se un evento specifico viene tracciato da un'origine specifica.For example a monitoring tool can notify an administrator if a specific event is traced by a specific source.

Per determinare se l'evento deve essere tracciato, vengono utilizzati i parametri eventCache e source.The eventCache and source parameters are used to determine if the event should be traced. id viene utilizzato per creare un oggetto EventInstance e il TraceEventType è equiparato a un EventLogEntryType per la proprietà EntryType.id is used to create an EventInstance object and the TraceEventType is equated to an EventLogEntryType for the EntryType property. Il EventInstance viene scritto nel registro eventi, utilizzando il metodo WriteEvent, con il messaggio ottenuto dai parametri format e args.The EventInstance is written to the event log, using the WriteEvent method, with the message obtained from the format and args parameters. La matrice di oggetti args viene convertita in una stringa utilizzando il metodo Format, passando la stringa format e la args matrice per formattare la stringa come messaggio per il registro eventi.The args object array is converted to a string using the Format method, passing the format string and args array to format the string as the message for the event log.

Nota

Il valore massimo del parametro id è 65.535.The maximum value of the id parameter is 65,535. Se il valore id specificato è maggiore di 65.535, viene utilizzato il valore massimo.If the id value specified is greater than 65,535, the maximum value is used.

Si applica a