TraceSource.TraceData Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
É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
- Source:
- TraceSource.cs
- 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")]
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)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
Exceptions
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.
S’applique à
TraceData(TraceEventType, Int32, Object[])
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
- 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")]
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())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
Exceptions
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.
