EventProvider.WriteMessageEvent 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 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 -> boolPublic Function WriteMessageEvent (eventMessage As String) As BooleanParamètres
- eventMessage
- String
Chaîne à écrire en tant que données de l'événement.
Retours
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
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.
S’applique à
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 -> boolPublic Function WriteMessageEvent (eventMessage As String, eventLevel As Byte, eventKeywords As Long) As BooleanParamè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
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
Exceptions
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.
