TraceSource.TraceEvent Méthode

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Écrit un message d'événement de trace dans les écouteurs de la trace de la collection Listeners.

Surcharges

TraceEvent(TraceEventType, Int32)	Écrit un message d’événement de trace dans les écouteurs de la trace de la collection Listeners à l’aide du type d’événement spécifié et de l’identificateur d’événement.
TraceEvent(TraceEventType, Int32, String)	Écrit un message d’événement 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 du message.
TraceEvent(TraceEventType, Int32, String, Object[])	Écrit un événement 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, du tableau des arguments et du format.

TraceEvent(TraceEventType, Int32)

Source:

TraceSource.cs

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

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 -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer)

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.

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 TraceEvent(TraceEventType, Int32) méthode pour passer un événement de trace aux écouteurs. Cet exemple de code fait partie d’un exemple plus grand fourni pour la TraceSource classe .

ts.TraceEvent(TraceEventType.Warning, 1);

ts.TraceEvent(TraceEventType.Warning, 1)

Remarques

La TraceEvent méthode est destinée à suivre les événements qui peuvent être traités automatiquement par les outils. Par exemple, un outil de surveillance peut avertir un administrateur si un événement spécifique est suivi par une source spécifique.

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

Le contenu de la trace est spécifique à l’écouteur. Si la méthode n’est pas remplacée par l’implémentation de l’écouteur, la sortie par défaut est le nom de la source de trace, son identité numérique et le type d’événement. Le contenu de trace supplémentaire dépend de la valeur de propriété de l’écouteur TraceOutputOptions .

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, le EventLogTraceListener utilise 65 535.

TraceEvent(TraceEventType, Int32, String)

Source:

TraceSource.cs

Écrit un message d’événement 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 du message.

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

Public Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)

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.

message

String

Message de trace à écrire.

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 TraceEvent(TraceEventType, Int32) méthode pour passer un événement de trace aux écouteurs. Cet exemple de code fait partie d’un exemple plus grand fourni pour 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")

Remarques

La TraceEvent méthode est destinée à suivre les événements qui peuvent être traités automatiquement par les outils. Par exemple, un outil de surveillance peut avertir un administrateur si un événement spécifique est suivi par une source spécifique.

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

Le contenu de la trace est spécifique à l’écouteur. Si la méthode n’est pas remplacée par l’implémentation de l’écouteur, la sortie par défaut est le nom de la source de trace, son identité numérique, le type d’événement et le message. Le contenu de trace supplémentaire dépend de la valeur de propriété de l’écouteur TraceOutputOptions .

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.

TraceEvent(TraceEventType, Int32, String, Object[])

Source:

TraceSource.cs

Écrit un événement 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, du tableau des arguments et du format.

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

Public Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args 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.

format

String

Chaîne de format composite qui contient du texte avec aucun ou plusieurs éléments de mise en forme qui correspondent à des objets du tableau args.

args

Object[]

object Tableau qui contient zéro ou plusieurs objets à mettre en forme.

Attributs

ConditionalAttribute

Exceptions

ArgumentNullException

format a la valeur null.

FormatException

format n'est pas valide.

- ou -

Le nombre qui indique un argument à mettre en forme est inférieur à zéro ou supérieur ou égal au nombre d'objets spécifiés à mettre en forme.

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 TraceEvent(TraceEventType, Int32) méthode pour passer un événement de trace aux écouteurs. Cet exemple de code fait partie d’un exemple plus grand fourni pour 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")

Remarques

Pour plus d’informations sur le format paramètre, consultez Mise en forme composite.

La TraceEvent méthode est destinée à suivre les événements qui peuvent être traités automatiquement par les outils. Par exemple, un outil de surveillance peut avertir un administrateur si un événement spécifique est suivi par une source spécifique.

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

Le contenu de la trace est spécifique à l’écouteur. La méthode par défaut TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) écrit le nom de la source, le type d’événement et l’identité numérique dans l’en-tête de trace, puis appelle la String.Format(IFormatProvider, String, Object[]) méthode, en transmettant la chaîne et args le format tableau et en utilisant la CultureInfo.InvariantCulture propriété pour mettre la chaîne en forme comme sortie du message.

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.

Voir aussi

• Mise en forme composite
• Chaînes de format numériques standard
• Custom Numeric Format Strings
• Chaînes de format DateTime standard
• Chaînes de format DateTime personnalisées
• Enumeration Format Strings
• Mettre en forme des types dans .NET