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 en guise de données.

Surcharges

WriteMessageEvent(String)	Écrit un événement qui contient une chaîne en guise de données.
WriteMessageEvent(String, Byte, Int64)	Écrit un événement qui contient une chaîne en guise de données si la valeur de niveau et de mot clé correspond 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 en guise 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 de l'événement.

Retours

Boolean

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

Exceptions

ArgumentException

Si eventMessage 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 si la session inclut des éléments de données étendus à l'événement.

WriteMessageEvent(String, Byte, Int64)

Écrit un événement qui contient une chaîne en guise de données si la valeur de niveau et de mot clé correspond 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 de l'é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 au 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 au même masque de mot clé défini dans le manifeste.

Retours

Boolean

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

Attributs

SecurityCriticalAttribute

Exceptions

ArgumentException

Si eventMessage 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 si la session inclut des éléments de données étendus à l'événement.