EventProvider.WriteMessageEvent Méthode

Définition

Espace de noms:
System.Diagnostics.Eventing
Assembly:
System.Core.dll

Écrit un événement qui contient une chaîne sous forme de données.

Surcharges

Nom Description
WriteMessageEvent(String)

Écrit un événement qui contient une chaîne sous forme de données.
WriteMessageEvent(String, Byte, Int64)

Écrit un événement qui contient une chaîne en tant que données si le niveau et la valeur du mot clé correspondent aux événements demandés par la session.

Remarques

Ces méthodes ne nécessitent pas de manifeste pour consommer l’événement.

WriteMessageEvent(String)

Écrit un événement qui contient une chaîne sous forme de données.

public:
 bool WriteMessageEvent(System::String ^ eventMessage);
public bool WriteMessageEvent(string eventMessage);
member this.WriteMessageEvent : string -> bool
Public Function WriteMessageEvent (eventMessage As String) As Boolean

Paramètres

eventMessage
String

Chaîne à écrire en tant que données d’événement.

Retours

Boolean

Est true si l’événement est écrit ; sinon, false. Si la valeur est false, appelez la GetLastWriteEventError() méthode pour déterminer la cause de l’échec.

Exceptions

ArgumentException

Si eventMessage c’est null.

Exemples

if (!provider.WriteMessageEvent("Event string."))
    Console.WriteLine(EventProvider.GetLastWriteEventError());

Remarques

La longueur de chaîne maximale est limitée à 64 Ko moins la taille des en-têtes d’événement. La taille de l’événement est inférieure si la taille de la mémoire tampon de la session est inférieure et que la session inclut des éléments de données étendus avec l’événement.

S’applique à

WriteMessageEvent(String, Byte, Int64)

Écrit un événement qui contient une chaîne en tant que données si le niveau et la valeur du mot clé correspondent aux événements demandés par la session.

public:
 bool WriteMessageEvent(System::String ^ eventMessage, System::Byte eventLevel, long eventKeywords);
[System.Security.SecurityCritical]
public bool WriteMessageEvent(string eventMessage, byte eventLevel, long eventKeywords);
[<System.Security.SecurityCritical>]
member this.WriteMessageEvent : string * byte * int64 -> bool
Public Function WriteMessageEvent (eventMessage As String, eventLevel As Byte, eventKeywords As Long) As Boolean

Paramètres

eventMessage
String

Chaîne à écrire en tant que données d’événement.

eventLevel
Byte

Niveau de détail inclus dans l’événement. Si le fournisseur utilise un manifeste pour définir l’événement, définissez cette valeur sur le même niveau défini dans le manifeste.

eventKeywords
Int64

Masque de bits qui spécifie la catégorie d’événement. Si le fournisseur utilise un manifeste pour définir l’événement, définissez cette valeur sur le même masque de mot clé défini dans le manifeste.

Retours

Boolean

Est true si l’événement est écrit ; sinon, false. Si la valeur est false, appelez la GetLastWriteEventError() méthode pour déterminer la cause de l’échec.

Attributs
SecurityCriticalAttribute

Exceptions

ArgumentException

Si eventMessage c’est null.

Exemples

// Calling this method with level and keyword set to zero is the same
// as calling WriteMessageEvent(string); the event is always written.
if (!provider.WriteMessageEvent("Event string.", 0, 0))
    Console.WriteLine(EventProvider.GetLastWriteEventError());

// Event is written if the level value of the session is less than or equal to 3, and bit 1 of the session
// keyword bit-mask is set.
if (!provider.WriteMessageEvent("Event string.", 3, 2))
    Console.WriteLine(EventProvider.GetLastWriteEventError());

Remarques

La longueur de chaîne maximale est limitée à 64 Ko moins la taille des en-têtes d’événement. La taille de l’événement est inférieure si la taille de la mémoire tampon de la session est inférieure et que la session inclut des éléments de données étendus avec l’événement.

S’applique à