EventLogTraceListener.TraceEvent Méthode

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.EventLog.dll

Paquet:

System.Diagnostics.EventLog v8.0.0

Écrit des informations de trace d'événements dans le journal des événements.

Surcharges

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Écrit des informations de traçage, un message et des informations d'événement dans le journal des événements.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Écrit des informations de traçage, un tableau mis en forme contenant des objets et des informations d'événement dans le journal des événements.

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

Source:

EventLogTraceListener.cs

Écrit des informations de traçage, un message et des informations d'événement dans le journal des événements.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ message);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string message);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, message As String)

Paramètres

eventCache

TraceEventCache

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

source

String

Nom utilisé pour identifier la sortie , généralement le nom de l'application qui a généré l'événement de trace.

severity

TraceEventType

Une des valeurs d'énumération qui spécifie le type de l'événement à l'origine du suivi.

id

Int32

Identificateur numérique pour l'événement. La combinaison de source et id identifie un événement de manière unique.

message

String

Message de trace.

Attributs

ComVisibleAttribute

Exceptions

ArgumentException

source n'est pas spécifié.

- ou -

La chaîne d'entrée de journal dépasse 32 766 caractères.

Remarques

Important

Les TraceEvent méthodes ne sont pas destinées à être appelées par le code de l’application. Ces méthodes sont appelées par les Debugméthodes des classes , Traceet TraceSource pour écrire des données de trace.

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.

Les eventCache paramètres et source sont utilisés pour déterminer si l’événement doit être suivi. id est utilisé pour créer un EventInstance objet et est TraceEventType équivalent à un EventLogEntryType pour la EntryType propriété . est EventInstance écrit dans le journal des événements avec les données à l’aide message de la WriteEvent méthode .

Notes

La valeur maximale du id paramètre est 65 535. Si la id valeur spécifiée est supérieure à 65 535, la valeur maximale est utilisée.

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

Source:

EventLogTraceListener.cs

Écrit des informations de traçage, un tableau mis en forme contenant des objets et des informations d'événement dans le journal des événements.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string format, params object[] args);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit

Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Paramètres

eventCache

TraceEventCache

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

source

String

Nom utilisé pour identifier la sortie , généralement le nom de l'application qui a généré l'événement de trace.

severity

TraceEventType

Une des valeurs d'énumération qui spécifie le type de l'événement à l'origine du suivi.

id

Int32

Identificateur numérique pour l'événement. La combinaison de source et id identifie un événement de manière unique.

format

String

Chaîne de format qui contient zéro, un ou plusieurs éléments de format qui correspondent à des objets dans le tableau args.

args

Object[]

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

Attributs

ComVisibleAttribute

Exceptions

ArgumentException

source n'est pas spécifié.

- ou -

La chaîne d'entrée de journal dépasse 32 766 caractères.

Remarques

Important

Les TraceEvent méthodes ne sont pas destinées à être appelées par le code de l’application. Ces méthodes sont appelées par les Debugméthodes des classes , Traceet TraceSource pour écrire des données de trace.

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.

Les eventCache paramètres et source sont utilisés pour déterminer si l’événement doit être suivi. id est utilisé pour créer un EventInstance objet et est TraceEventType équivalent à un EventLogEntryType pour la EntryType propriété . le EventInstance est écrit dans le journal des événements, à l’aide de la WriteEvent méthode , avec le message obtenu à partir des format paramètres et args . Le args tableau d’objets est converti en chaîne à l’aide de la Format méthode , en passant la chaîne et args le format tableau pour mettre en forme la chaîne en tant que message pour le journal des événements.

Notes

La valeur maximale du id paramètre est 65 535. Si la id valeur spécifiée est supérieure à 65 535, la valeur maximale est utilisée.