EventLogTraceListener.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 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
- Source:
- EventLogTraceListener.cs
- 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 -> unitPublic 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
Exceptions
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.
S’applique à
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])
- Source:
- EventLogTraceListener.cs
- Source:
- EventLogTraceListener.cs
- 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[] -> unitPublic 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
Exceptions
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.
