EventLogTraceListener.TraceEvent Metodo

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Pacchetto:

System.Diagnostics.EventLog v8.0.0

Scrive le informazioni di traccia di evento nel log eventi.

Overload

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Scrive le informazioni di traccia, un messaggio e le informazioni di evento nel log eventi.
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.

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

Source:

EventLogTraceListener.cs

Scrive le informazioni di traccia, un messaggio e le informazioni di evento nel log eventi.

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)

Parametri

eventCache

TraceEventCache

Oggetto che contiene l'ID processo corrente, l'ID thread e le informazioni di analisi dello stack.

source

String

Nome utilizzato per identificare l'output. In genere corrisponde al nome dell'applicazione che ha generato l'evento di traccia.

severity

TraceEventType

Uno dei valori di enumerazione che specifica il tipo di evento che ha causato la traccia.

id

Int32

Identificatore numerico per l'evento. La combinazione di source e id identifica un evento in modo univoco.

message

String

Messaggi di traccia.

Attributi

ComVisibleAttribute

Eccezioni

ArgumentException

source non specificato.

-oppure-

La stringa della voce di log supera il limite di 32.766 caratteri.

Commenti

Importante

I TraceEvent metodi non devono essere chiamati dal codice dell'applicazione. Questi metodi vengono chiamati dai metodi delle Debugclassi , Tracee TraceSource per scrivere dati di traccia.

Il TraceEvent metodo è progettato per tracciare gli eventi che possono essere elaborati automaticamente dagli strumenti. Ad esempio, uno strumento di monitoraggio può inviare una notifica a un amministratore se un evento specifico viene tracciato da un'origine specifica.

I eventCache parametri e source vengono usati per determinare se l'evento deve essere tracciato. id viene utilizzato per creare un EventInstance oggetto e l'oggetto TraceEventType è equivalente a un EventLogEntryType oggetto per la EntryType proprietà . L'oggetto EventInstance viene scritto nel registro eventi con i message dati usando il WriteEvent metodo .

Nota

Il valore massimo del id parametro è 65.535. Se il id valore specificato è maggiore di 65.535, viene utilizzato il valore massimo.

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

Source:

EventLogTraceListener.cs

Scrive le informazioni di traccia, una matrice formattata di oggetti e le informazioni di evento nel log eventi.

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())

Parametri

eventCache

TraceEventCache

Oggetto che contiene l'ID processo corrente, l'ID thread e le informazioni di analisi dello stack.

source

String

Nome utilizzato per identificare l'output. In genere corrisponde al nome dell'applicazione che ha generato l'evento di traccia.

severity

TraceEventType

Uno dei valori di enumerazione che specifica il tipo di evento che ha causato la traccia.

id

Int32

Identificatore numerico per l'evento. La combinazione di source e id identifica un evento in modo univoco.

format

String

Stringa di formato che contiene zero o più elementi di formato, corrispondenti a oggetti nella matrice args.

args

Object[]

Matrice object che contiene zero o più oggetti da formattare.

Attributi

ComVisibleAttribute

Eccezioni

ArgumentException

source non specificato.

-oppure-

La stringa della voce di log supera il limite di 32.766 caratteri.

Commenti

Importante

I TraceEvent metodi non devono essere chiamati dal codice dell'applicazione. Questi metodi vengono chiamati dai metodi delle Debugclassi , Tracee TraceSource per scrivere dati di traccia.

Il TraceEvent metodo è progettato per tracciare gli eventi che possono essere elaborati automaticamente dagli strumenti. Ad esempio, uno strumento di monitoraggio può inviare una notifica a un amministratore se un evento specifico viene tracciato da un'origine specifica.

I eventCache parametri e source vengono usati per determinare se l'evento deve essere tracciato. id viene utilizzato per creare un EventInstance oggetto e l'oggetto TraceEventType è equivalente a un EventLogEntryType oggetto per la EntryType proprietà . L'oggetto EventInstance viene scritto nel registro eventi, usando il WriteEvent metodo , con il messaggio ottenuto dai format parametri e args . La args matrice di oggetti viene convertita in una stringa usando il Format metodo , passando la stringa e args la format matrice per formattare la stringa come messaggio per il registro eventi.

Nota

Il valore massimo del id parametro è 65.535. Se il id valore specificato è maggiore di 65.535, viene utilizzato il valore massimo.