TraceSource.TraceEvent 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 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 -> unitPublic 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 -> unitPublic 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[] -> unitPublic 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
- Formattazione composita
- Stringhe di formato numerico standard
- Stringhe di formato numerico personalizzato
- Stringhe di formato DateTime standard
- Stringhe di formato DateTime personalizzate
- Stringhe di formato di enumerazione
- Formattazione di tipi in .NET
