FileLogTraceListener.TraceEvent Méthode

Définition

Écrit les informations sur la trace et sur les événements dans le fichier ou le flux de sortie.

Surcharges

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Écrit des informations de traçage, un message et des informations d'événement dans le fichier ou le flux de sortie.

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

Écrit des informations de traçage, un tableau d'objets mis en forme et des informations d'événement dans le fichier ou le flux de sortie.

Remarques

TraceEvent les méthodes ne sont pas destinées à être appelées par le code d’application. Ces méthodes sont appelées par les Debugmembres des classes , Traceet TraceSource pour écrire des données de trace dans la sortie.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Écrit des informations de traçage, un message et des informations d'événement dans le fichier ou le flux de sortie.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string message);
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, message As String)

Paramètres

eventCache
TraceEventCache

Objet TraceEventCache qui contient les informations actuelles sur l'ID de processus, l'ID de thread et la trace de la pile.

source
String

Nom de la source de trace qui a appelé cette méthode.

eventType
TraceEventType

Une des valeurs d'énumération TraceEventType.

id
Int32

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

message
String

Message à écrire.

Remarques

Cette méthode :

  1. Met en forme les données et les informations de contexte pour la sortie.

  2. Crée un fichier journal, si nécessaire.

  3. Écrit les informations dans le fichier journal.

Pour plus d’informations sur la création de fichiers journaux, consultez FullLogFileName.

Ce tableau répertorie les champs de sortie dans l’ordre dans lequel ils apparaissent. Les champs sont délimités par la chaîne spécifiée par la Delimiter propriété et sont suivis d’un point de terminaison de ligne.

Champ Condition de sortie Description
source Toujours. la valeur de la propriété name ;
severity Toujours. Nom de la valeur d’énumération de eventType.
id Toujours. Représentation sous forme de chaîne de id.
message Toujours. la valeur de la propriété message ;
callStack Lorsque l’indicateur Callstack est défini dans la TraceOutputOptions propriété . Propriété Callstack de eventCache.
CorrelationID Lorsque l’indicateur LogicalOperationStack est défini dans la TraceOutputOptions propriété . Propriété ThreadId de eventCache.
DateTime Lorsque l’indicateur DateTime est défini dans la TraceOutputOptions propriété . Représentation sous forme de chaîne de la DateTime propriété de eventCache. La culture invariante est utilisée pour la conversion de chaîne.
ProcessID Lorsque l’indicateur ProcessId est défini dans la TraceOutputOptions propriété . Représentation sous forme de chaîne de la ProcessId propriété de eventCache. La culture invariante est utilisée pour la conversion de chaîne.
ThreadID Lorsque l’indicateur ThreadId est défini dans la TraceOutputOptions propriété . Propriété ThreadId de eventCache.
Timestamp Lorsque l’indicateur Timestamp est défini dans la TraceOutputOptions propriété . Représentation sous forme de chaîne de la Timestamp propriété de eventCache. La culture invariante est utilisée pour la conversion de chaîne.
HostName Lorsque la IncludeHostName propriété est True. Nom de l'ordinateur.

Voir aussi

S’applique à

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

Écrit des informations de traçage, un tableau d'objets mis en forme et des informations d'événement dans le fichier ou le flux de sortie.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Paramètres

eventCache
TraceEventCache

Objet TraceEventCache qui contient les informations actuelles sur l'ID de processus, l'ID de thread et la trace de la pile.

source
String

Nom de la source de trace qui a appelé cette méthode.

eventType
TraceEventType

Une des valeurs d'énumération TraceEventType.

id
Int32

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

format
String

Chaîne de format qui contient zéro élément de format ou plus, lesquels correspondent aux objets dans le tableau args.

args
Object[]

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

Remarques

Cette méthode :

  1. Met en forme les données et les informations de contexte pour la sortie.

  2. Crée un nouveau fichier journal, si nécessaire.

  3. Écrit les informations dans le fichier journal.

Pour plus d’informations sur la création d’un fichier journal, consultez FullLogFileName.

Ce tableau répertorie les champs de sortie dans l’ordre dans lequel ils apparaissent. Les champs sont délimités par la chaîne spécifiée par la Delimiter propriété et suivis d’un point de terminaison de ligne.

Champ Condition de sortie Description
source Toujours la valeur de la propriété name ;
severity Toujours Nom de la valeur d’énumération de eventType.
id Toujours Représentation sous forme de chaîne de id.
message Toujours Données mises en args forme avec la format chaîne et à l’aide de la culture invariante pour les conversions de chaînes.
callStack Lorsque l’indicateur Callstack est défini dans la TraceOutputOptions propriété . Propriété Callstack de eventCache.
CorrelationID Lorsque l’indicateur LogicalOperationStack est défini dans la TraceOutputOptions propriété . Propriété ThreadId de eventCache.
DateTime Lorsque l’indicateur DateTime est défini dans la TraceOutputOptions propriété . Représentation sous forme de chaîne de la DateTime propriété de eventCache. La culture invariante est utilisée pour la conversion de chaîne.
ProcessID Lorsque l’indicateur ProcessId est défini dans la TraceOutputOptions propriété . Représentation sous forme de chaîne de la ProcessId propriété de eventCache. La culture invariante est utilisée pour la conversion de chaîne.
ThreadID Lorsque l’indicateur ThreadId est défini dans la TraceOutputOptions propriété . Propriété ThreadId de eventCache.
Timestamp Lorsque l’indicateur Timestamp est défini dans la TraceOutputOptions propriété . Représentation sous forme de chaîne de la Timestamp propriété de eventCache. La culture invariante est utilisée pour la conversion de chaîne.
HostName Lorsque la IncludeHostName propriété est True. Nom de l'ordinateur.

Voir aussi

S’applique à