EventLogTraceListener.TraceData Metodo

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Pacchetto:

System.Diagnostics.EventLog v8.0.0

Scrive i dati di traccia nel log eventi.

Overload

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Scrive le informazioni di traccia, un oggetto dati e le informazioni di evento nel log eventi.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Scrive le informazioni di traccia, una matrice di oggetti dati e le informazioni di evento nel log eventi.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Source:

EventLogTraceListener.cs

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

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::Object ^ data);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, object data);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, data 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.

data

Object

Oggetto dati da scrivere nel flusso o nel file di output.

Attributi

ComVisibleAttribute

Eccezioni

ArgumentException

source non specificato.

-oppure-

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

Commenti

Importante

I TraceData metodi non devono essere chiamati dal codice dell'applicazione. Vengono chiamati dai metodi delle Debugclassi , Tracee TraceSource per restituire i dati di traccia.

Il TraceData metodo, ad esempio un'istanza TraceEvent di eccezione, è destinato agli strumenti automatizzati, ma consente anche il collegamento di oggetti aggiuntivi, ad esempio un'istanza di eccezione, alla traccia.

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 l'oggetto data , formattato come stringa, 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.

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

Source:

EventLogTraceListener.cs

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

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, ... cli::array <System::Object ^> ^ data);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, params object[] data);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, ParamArray data 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.

data

Object[]

Matrice di oggetti dati.

Attributi

ComVisibleAttribute

Eccezioni

ArgumentException

source non specificato.

-oppure-

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

Commenti

Importante

I TraceData metodi non devono essere chiamati dal codice dell'applicazione. Vengono chiamati dai metodi delle Debugclassi , Tracee TraceSource per restituire i dati di traccia.

Il TraceData metodo, ad esempio un'istanza TraceEvent di eccezione, è destinato agli strumenti automatizzati, ma consente anche il collegamento di oggetti aggiuntivi, ad esempio un'istanza di eccezione, alla traccia.

I dati dei severity parametri e id vengono usati per creare un EventInstance oggetto, scritto nel registro eventi con i dati della matrice di oggetti dati.

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 la data matrice di oggetti, formattata come matrice di stringhe, 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.