TraceSource.TraceEvent Metodo

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

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

Overload

TraceEvent(TraceEventType, Int32)	Scrive un messaggio di evento di traccia nei listener di traccia nella raccolta Listeners utilizzando 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 nella raccolta Listeners utilizzando 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 nella raccolta Listeners utilizzando il tipo di evento, l'identificatore di evento e la matrice di argomenti e il formato specificati.

TraceEvent(TraceEventType, Int32)

Origine:

TraceSource.cs

Scrive un messaggio di evento di traccia nei listener di traccia nella raccolta Listeners utilizzando 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

ConditionalAttribute

Eccezioni

ObjectDisposedException

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

Esempio

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

ts.TraceEvent(TraceEventType.Warning, 1);

ts.TraceEvent(TraceEventType.Warning, 1)

Commenti

Il metodo TraceEvent è 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.

Il metodo TraceEvent chiama il metodo ShouldTrace dell'oggetto SourceSwitch restituito dalla proprietà Switch. Se ShouldTrace restituisce true, TraceEvent chiama il metodo TraceEvent corrispondente 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à TraceOutputOptions del listener.

Nota

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

TraceEvent(TraceEventType, Int32, String)

Origine:

TraceSource.cs

Scrive un messaggio di evento di traccia nei listener di traccia nella raccolta Listeners utilizzando 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")>]
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

ConditionalAttribute

Eccezioni

ObjectDisposedException

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

Esempio

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

// 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 metodo TraceEvent è 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.

Il metodo TraceEvent chiama il metodo ShouldTrace dell'oggetto SourceSwitch restituito dalla proprietà Switch. Se ShouldTrace restituisce true, TraceEvent chiama il metodo TraceEvent corrispondente 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à TraceOutputOptions del listener.

Nota

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

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

Origine:

TraceSource.cs

Scrive un evento di traccia nei listener di traccia nella raccolta Listeners utilizzando il tipo di evento, l'identificatore di evento e 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")>]
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 composito che contiene testo mescolato con zero o più elementi di formato, che corrispondono agli oggetti nella matrice args.

args

Object[]

Matrice object contenente zero o più oggetti da formattare.

Attributi

ConditionalAttribute

Eccezioni

ArgumentNullException

format è null.

FormatException

format non è valido.

-o-

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

ObjectDisposedException

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

Esempio

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

// 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 parametro format, vedere Formattazione composita.

Il metodo TraceEvent è 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.

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

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

Nota

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

Vedi anche

• formattazione composita
• stringhe di formato numerico standard
• stringhe di formato numerico personalizzate
• stringhe di formato DateTime standard
• stringhe di formato DateTime personalizzate
• formato di enumerazione stringhe
• Tipi di formattazione in .NET