FileLogTraceListener.TraceEvent 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 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 :
Met en forme les données et les informations de contexte pour la sortie.
Crée un fichier journal, si nécessaire.
É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 :
Met en forme les données et les informations de contexte pour la sortie.
Crée un nouveau fichier journal, si nécessaire.
É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. |