TraceSource.TraceData Méthode

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Écrit des données de trace dans les écouteurs de la trace de la collection Listeners.

Surcharges

TraceData(TraceEventType, Int32, Object)	Écrit les données de trace dans les écouteurs de la trace de la collection Listeners à l'aide du type d'événement spécifié, de l'identificateur d'événement et des données de trace.
TraceData(TraceEventType, Int32, Object[])	Écrit les données de trace dans les écouteurs de la trace de la collection Listeners à l’aide du type d’événement spécifié, de l’identificateur d’événement et des données de trace.

TraceData(TraceEventType, Int32, Object)

Source:

TraceSource.cs

Écrit les données de trace dans les écouteurs de la trace de la collection Listeners à l'aide du type d'événement spécifié, de l'identificateur d'événement et des données de trace.

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")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj -> unit

Public Sub TraceData (eventType As TraceEventType, id As Integer, data As Object)

Paramètres

eventType

TraceEventType

Une des valeurs d'énumération qui spécifie le type de l'événement des données de trace.

id

Int32

Identificateur numérique pour l'événement.

data

Object

Données de trace.

Attributs

ConditionalAttribute

Exceptions

ObjectDisposedException

Une tentative de tracer un événement lors de la finalisation a été effectuée.

Exemples

L’exemple de code suivant montre l’utilisation de la TraceData(TraceEventType, Int32, Object) méthode pour filtrer et transférer un message de trace aux écouteurs. Cet exemple de code fait partie d’un exemple plus grand fourni pour 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.")

Remarques

La TraceData méthode, comme la TraceEvent méthode, est destinée aux outils automatisés, mais elle permet également l’attachement d’un objet supplémentaire, tel qu’une exception instance, à la trace.

La TraceData méthode appelle la SourceSwitch.ShouldTrace méthode de l’objet SourceSwitch retourné par la Switch propriété . Si ShouldTrace retourne true, TraceData appelle la méthode correspondante TraceData sur tous les écouteurs. Sinon, TraceData retourne sans appeler les méthodes des écouteurs.

Notes

L’objet EventLogTraceListener est limité à une valeur maximale id de 65 535. Si la id valeur spécifiée est supérieure à 65 535, l’objet EventLogTraceListener utilise 65 535.

TraceData(TraceEventType, Int32, Object[])

Source:

TraceSource.cs

Écrit les données de trace dans les écouteurs de la trace de la collection Listeners à l’aide du type d’événement spécifié, de l’identificateur d’événement et des données de trace.

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")>]
member this.TraceData : System.Diagnostics.TraceEventType * int * obj[] -> unit

Public Sub TraceData (eventType As TraceEventType, id As Integer, ParamArray data As Object())

Paramètres

eventType

TraceEventType

Une des valeurs d'énumération qui spécifie le type de l'événement des données de trace.

id

Int32

Identificateur numérique pour l'événement.

data

Object[]

Tableau d'objets qui contient les données de trace.

Attributs

ConditionalAttribute

Exceptions

ObjectDisposedException

Une tentative de tracer un événement lors de la finalisation a été effectuée.

Remarques

La TraceData méthode, comme la TraceEvent méthode, est destinée aux outils automatisés, mais elle permet également l’attachement d’objets supplémentaires, tels qu’une exception instance et une trace de pile, à la trace.

La TraceData méthode appelle la ShouldTrace méthode de l’objet SourceSwitch retourné par la Switch propriété . Si ShouldTrace retourne true, TraceData appelle la méthode correspondante TraceData sur tous les écouteurs. Sinon, TraceData retourne sans appeler les méthodes des écouteurs.

Notes

L’objet EventLogTraceListener est limité à une valeur maximale id de 65 535. Si la id valeur spécifiée est supérieure à 65 535, l’objet EventLogTraceListener utilise 65 535.