Condividi tramite


TraceSource.TraceData Metodo

Definizione

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 -> unit
Public 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[] -> unit
Public 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.

Si applica a