EventLogTraceListener.TraceData Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
- Source:
- EventLogTraceListener.cs
- 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
Eccezioni
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.
Si applica a
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])
- Source:
- EventLogTraceListener.cs
- Source:
- EventLogTraceListener.cs
- 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
Eccezioni
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.