TraceSource.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 nei listener di traccia della raccolta Listeners.
Overload
| TraceData(TraceEventType, Int32, Object) |
Scrive i dati di traccia nei listener di traccia della raccolta Listeners usando il tipo di evento, l'identificatore di evento e i dati di traccia specificati. |
| TraceData(TraceEventType, Int32, Object[]) |
Scrive i dati di traccia nei listener di traccia della raccolta Listeners usando il tipo di evento, l'identificatore di evento e la matrice di dati di traccia specificati. |
TraceData(TraceEventType, Int32, Object)
- Origine:
- TraceSource.cs
- Origine:
- TraceSource.cs
- Origine:
- TraceSource.cs
Scrive i dati di traccia nei listener di traccia della raccolta Listeners usando il tipo di evento, l'identificatore di evento e i dati di traccia specificati.
public:
void TraceData(System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);[System.Diagnostics.Conditional("TRACE")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, object? data);[System.Diagnostics.Conditional("TRACE")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, object data);[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj -> unitPublic Sub TraceData (eventType As TraceEventType, id As Integer, data 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.
- data
- Object
Dati di traccia.
- Attributi
Eccezioni
È stato effettuato un tentativo di tracciare un evento durante la finalizzazione.
Esempio
Nell'esempio TraceData(TraceEventType, Int32, Object) di codice seguente viene illustrato l'uso del metodo per filtrare e inoltrare un messaggio di traccia ai listener. Questo esempio di codice fa parte di un esempio più grande fornito per la TraceSource classe.
// Test the filter on the ConsoleTraceListener.
ts.Listeners["console"].Filter = new SourceFilter("No match");
ts.TraceData(TraceEventType.Error, 5,
"SourceFilter should reject this message for the console trace listener.");
ts.Listeners["console"].Filter = new SourceFilter("TraceTest");
ts.TraceData(TraceEventType.Error, 6,
"SourceFilter should let this message through on the console trace listener.");
' Test the filter on the ConsoleTraceListener.
ts.Listeners("console").Filter = New SourceFilter("No match")
ts.TraceData(TraceEventType.Error, 5, "SourceFilter should reject this message for the console trace listener.")
ts.Listeners("console").Filter = New SourceFilter("TraceTest")
ts.TraceData(TraceEventType.Error, 6, "SourceFilter should let this message through on the console trace listener.")
Commenti
Il TraceData metodo, come il TraceEvent metodo, è destinato agli strumenti automatizzati, ma consente anche il collegamento di un oggetto aggiuntivo, ad esempio un'istanza di eccezione, alla traccia.
Il TraceData metodo chiama il SourceSwitch.ShouldTrace metodo dell'oggetto SourceSwitch restituito dalla Switch proprietà . Se ShouldTrace restituisce true, TraceData chiama il metodo corrispondente TraceData su tutti i listener. In caso contrario, TraceData restituisce senza chiamare i metodi dei listener.
Nota
L'oggetto EventLogTraceListener è limitato a un valore massimo id pari a 65.535. Se il valore specificato è maggiore di 65.535, l'oggetto idEventLogTraceListener usa 65.535.
Si applica a
TraceData(TraceEventType, Int32, Object[])
- Origine:
- TraceSource.cs
- Origine:
- TraceSource.cs
- Origine:
- TraceSource.cs
Scrive i dati di traccia nei listener di traccia della raccolta Listeners usando il tipo di evento, l'identificatore di evento e la matrice di dati di traccia specificati.
public:
void TraceData(System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);[System.Diagnostics.Conditional("TRACE")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, params object?[]? data);[System.Diagnostics.Conditional("TRACE")]
public void TraceData (System.Diagnostics.TraceEventType eventType, int id, params object[] data);[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj[] -> unitPublic Sub TraceData (eventType As TraceEventType, id As Integer, ParamArray data 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.
- data
- Object[]
Matrice di oggetti contenente i dati di traccia.
- Attributi
Eccezioni
È stato effettuato un tentativo di tracciare un evento durante la finalizzazione.
Commenti
Il TraceData metodo, come il TraceEvent metodo, è destinato agli strumenti automatizzati, ma consente anche l'associazione di oggetti aggiuntivi, ad esempio un'istanza di eccezione e una traccia dello stack, alla traccia.
Il TraceData metodo chiama il ShouldTrace metodo dell'oggetto SourceSwitch restituito dalla Switch proprietà . Se ShouldTrace restituisce true, TraceData chiama il metodo corrispondente TraceData su tutti i listener. In caso contrario, TraceData restituisce senza chiamare i metodi dei listener.
Nota
L'oggetto EventLogTraceListener è limitato a un valore massimo id pari a 65.535. Se il valore specificato è maggiore di 65.535, l'oggetto idEventLogTraceListener usa 65.535.
