Condividi tramite


TraceSource.TraceEvent Metodo

Definizione

Scrive un messaggio di evento di traccia nei listener di traccia della raccolta Listeners.

Overload

TraceEvent(TraceEventType, Int32)

Scrive un messaggio di evento di traccia nei listener di traccia della raccolta Listeners usando il tipo di evento e l'identificatore di evento specificati.

TraceEvent(TraceEventType, Int32, String)

Scrive un messaggio di evento di traccia nei listener di traccia della raccolta Listeners usando il tipo di evento, l'identificatore di evento e il messaggio specificati.

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

Scrive un evento di traccia nei listener di traccia della raccolta Listeners usando il tipo di evento, l'identificatore di evento, la matrice di argomenti e il formato specificati.

TraceEvent(TraceEventType, Int32)

Origine:
TraceSource.cs
Origine:
TraceSource.cs
Origine:
TraceSource.cs

Scrive un messaggio di evento di traccia nei listener di traccia della raccolta Listeners usando il tipo di evento e l'identificatore di evento specificati.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer)

Parametri

eventType
TraceEventType

Uno dei valori di enumerazione che specifica il tipo di evento dei dati di traccia.

id
Int32

Identificatore numerico per l'evento.

Attributi

Eccezioni

È stato effettuato un tentativo di tracciare un evento durante la finalizzazione.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del metodo per passare un evento di TraceEvent(TraceEventType, Int32) traccia ai listener. Questo esempio di codice fa parte di un esempio più ampio fornito per la TraceSource classe .

ts.TraceEvent(TraceEventType.Warning, 1);
ts.TraceEvent(TraceEventType.Warning, 1)

Commenti

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

Il TraceEvent metodo chiama il ShouldTrace metodo dell'oggetto SourceSwitch restituito dalla Switch proprietà . Se ShouldTrace restituisce true, TraceEvent chiama il metodo corrispondente TraceEvent di ogni listener. In caso contrario, TraceEvent restituisce senza chiamare i metodi dei listener.

Il contenuto della traccia è specifico del listener. Se il metodo non viene sottoposto a override dall'implementazione del listener, l'output predefinito è il nome dell'origine di traccia, la relativa identità numerica e il tipo di evento. Il contenuto di traccia aggiuntivo dipende dal valore della proprietà del TraceOutputOptions listener.

Nota

L'oggetto EventLogTraceListener è limitato a un valore massimo id di 65.535. Se il id valore specificato è maggiore di 65.535, EventLogTraceListener usa 65.535.

Si applica a

TraceEvent(TraceEventType, Int32, String)

Origine:
TraceSource.cs
Origine:
TraceSource.cs
Origine:
TraceSource.cs

Scrive un messaggio di evento di traccia nei listener di traccia della raccolta Listeners usando il tipo di evento, l'identificatore di evento e il messaggio specificati.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? message);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string message);
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)

Parametri

eventType
TraceEventType

Uno dei valori di enumerazione che specifica il tipo di evento dei dati di traccia.

id
Int32

Identificatore numerico per l'evento.

message
String

Messaggio di traccia da scrivere.

Attributi

Eccezioni

È stato effettuato un tentativo di tracciare un evento durante la finalizzazione.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del metodo per passare un evento di TraceEvent(TraceEventType, Int32) traccia ai listener. Questo esempio di codice fa parte di un esempio più ampio fornito per la TraceSource classe .

// Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found");
' Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found")

Commenti

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

Il TraceEvent metodo chiama il ShouldTrace metodo dell'oggetto SourceSwitch restituito dalla Switch proprietà . Se ShouldTrace restituisce true, TraceEvent chiama il metodo corrispondente TraceEvent di ogni listener. In caso contrario, TraceEvent restituisce senza chiamare i metodi dei listener.

Il contenuto della traccia è specifico del listener. Se il metodo non viene sottoposto a override dall'implementazione del listener, l'output predefinito è il nome dell'origine di traccia, la relativa identità numerica, il tipo di evento e il messaggio. Il contenuto di traccia aggiuntivo dipende dal valore della proprietà del TraceOutputOptions listener.

Nota

L'oggetto EventLogTraceListener è limitato a un valore massimo id di 65.535. Se il id valore specificato è maggiore di 65.535, l'oggetto EventLogTraceListener utilizza 65.535.

Si applica a

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

Origine:
TraceSource.cs
Origine:
TraceSource.cs
Origine:
TraceSource.cs

Scrive un evento di traccia nei listener di traccia della raccolta Listeners usando il tipo di evento, l'identificatore di evento, la matrice di argomenti e il formato specificati.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object?[]? args);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Parametri

eventType
TraceEventType

Uno dei valori di enumerazione che specifica il tipo di evento dei dati di traccia.

id
Int32

Identificatore numerico per l'evento.

format
String

Stringa di formato composta che contiene testo combinato con zero o più elementi di formato, che corrispondono agli oggetti nella matrice args.

args
Object[]

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

Attributi

Eccezioni

format è null.

format non è valido.

-oppure-

Il numero che indica un argomento da formattare è minore di zero oppure maggiore o uguale al numero di oggetti specificati da formattare.

È stato effettuato un tentativo di tracciare un evento durante la finalizzazione.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del metodo per passare un evento di TraceEvent(TraceEventType, Int32) traccia ai listener. Questo esempio di codice fa parte di un esempio più ampio fornito per la TraceSource classe .

// Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test");
' Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test")

Commenti

Per altre informazioni sul format parametro , vedere Formattazione composita.

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

Il TraceEvent metodo chiama il ShouldTrace metodo dell'oggetto SourceSwitch restituito dalla Switch proprietà . Se ShouldTrace restituisce true, TraceEvent chiama il metodo corrispondente TraceEvent di ogni listener. In caso contrario, TraceEvent restituisce senza chiamare i metodi dei listener.

Il contenuto della traccia è specifico del listener. Il metodo predefinito TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) scrive il nome di origine, il tipo di evento e l'identità numerica nell'intestazione di traccia, quindi chiama il String.Format(IFormatProvider, String, Object[]) metodo , passando la format stringa e args la matrice e usando la CultureInfo.InvariantCulture proprietà per formattare la stringa come output del messaggio.

Nota

L'oggetto EventLogTraceListener è limitato a un valore massimo id di 65.535. Se il id valore specificato è maggiore di 65.535, l'oggetto EventLogTraceListener utilizza 65.535.

Vedi anche

Si applica a