EventProvider.WriteEvent Méthode

Référence

Définition

Espace de noms:: System.Diagnostics.Eventing

Assembly:: System.Core.dll

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.

Surcharges

WriteEvent(EventDescriptor, Object[])	Écrit un événement. Les données d'événement sont spécifiées comme un tableau d'objets.
WriteEvent(EventDescriptor, String)	Écrit un événement. Les données de l'événement sont spécifiées comme une chaîne.
WriteEvent(EventDescriptor, Int32, IntPtr)	Écrit un événement. Les données de l'événement sont spécifiées comme un bloc de mémoire.

Remarques

Utilisez ces méthodes si vous utilisez un manifeste pour définir vos événements.

WriteEvent(EventDescriptor, Object[])

Écrit un événement. Les données d'événement sont spécifiées comme un tableau d'objets.

public:
 bool WriteEvent(System::Diagnostics::Eventing::EventDescriptor % eventDescriptor, ... cli::array <System::Object ^> ^ eventPayload);

[System.Security.SecurityCritical]
public bool WriteEvent (ref System.Diagnostics.Eventing.EventDescriptor eventDescriptor, params object[] eventPayload);

public bool WriteEvent (ref System.Diagnostics.Eventing.EventDescriptor eventDescriptor, params object[] eventPayload);

[<System.Security.SecurityCritical>]
member this.WriteEvent : EventDescriptor * obj[] -> bool

member this.WriteEvent : EventDescriptor * obj[] -> bool

Public Function WriteEvent (ByRef eventDescriptor As EventDescriptor, ParamArray eventPayload As Object()) As Boolean

Paramètres

eventDescriptor: EventDescriptor

Instance de EventDescriptor qui identifie l'événement à écrire.

eventPayload: Object[]

Tableau d'objets qui contient les données d'événement à écrire. L'objet doit être dans l'ordre spécifié dans le manifeste. Le tableau est limité à 32 objets, dont huit seulement peuvent être des chaînes. La taille maximale des données pour l'événement est limitée à 64 Ko, moins la taille des en-têtes de l'é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.

Ce paramètre peut avoir la valeur Null.

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

Le paramètre eventPayload contient trop d'objets ou chaînes.

Exemples

private static Guid providerId = new Guid("{FB33FDA8-45FB-4df0-8A55-EEB4BA88E7E7}");  

enum Keyword  
{  
    Read = 0x1,  
    Write = 0x2,  
    Local = 0x4,  
    Remote = 0x8  
}  

enum Level  
{  
    Critical = 1,  
    Error,  
    Warning,  
    Information,  
    Verbose  
}  

    EventProvider provider = new EventProvider(providerId);  
    EventDescriptor readEvent;  
    string path = @"<PATHGOESHERE>";  
    UInt64 bytesRead = <ASSIGNVALUE>;  

    if (provider.IsEnabled(Level.Information, (long)Keyword.Read))  
    {  
        unchecked  
        {  
            readEvent = new EventDescriptor(0x1, 0x0, 0x10, 0x4, 0x0, 0x0, (long)0x8000000000000005);  
        }  

        if (!provider.WriteEvent(ref readEvent, new object[] { path, bytesRead }))  
            Console.WriteLine(EventProvider.GetLastWriteEventError());  
    }  

    provider.Close();

Remarques

Si vous appelez la SetActivityId méthode pour spécifier un identificateur d’activité pour l’événement, cette méthode récupère l’identificateur du contexte de thread et l’inclut avec l’événement.

Si le type d’objet n’est pas pris en charge, la méthode écrit la valeur de la méthode de Object.ToString l’objet dans la charge utile. Pour obtenir la liste des types d’objets pris en charge, consultez Les remarques de la EventProvider classe .

S’applique à

WriteEvent(EventDescriptor, String)

Écrit un événement. Les données de l'événement sont spécifiées comme une chaîne.

public:
 bool WriteEvent(System::Diagnostics::Eventing::EventDescriptor % eventDescriptor, System::String ^ data);

[System.Security.SecurityCritical]
public bool WriteEvent (ref System.Diagnostics.Eventing.EventDescriptor eventDescriptor, string data);

[<System.Security.SecurityCritical>]
member this.WriteEvent : EventDescriptor * string -> bool

Public Function WriteEvent (ByRef eventDescriptor As EventDescriptor, data As String) As Boolean

Paramètres

eventDescriptor: EventDescriptor

Instance de EventDescriptor qui identifie l'événement à écrire.

data: 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.

Attributs: SecurityCriticalAttribute

Exceptions

ArgumentException

Si data est null.

Exemples

private static Guid providerId = new Guid("{FB33FDA8-45FB-4df0-8A55-EEB4BA88E7E7}");  

EventProvider provider = new EventProvider(providerId);  
EventDescriptor writeEvent;  

if (provider.IsEnabled())  
{  
     unchecked  
     {  
          writeEvent = new EventDescriptor(0x2, 0x0, 0x10, 0x3, 0x0, 0x0, (long)0x8000000000000006);  
     }  

     if (!provider.WriteEvent(ref writeEvent, "Write event."))  
          Console.WriteLine(EventProvider.GetLastWriteEventError());  
}  

provider.Close();

Remarques

La longueur maximale de chaîne 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 à

WriteEvent(EventDescriptor, Int32, IntPtr)

Écrit un événement. Les données de l'événement sont spécifiées comme un bloc de mémoire.

protected:
 bool WriteEvent(System::Diagnostics::Eventing::EventDescriptor % eventDescriptor, int dataCount, IntPtr data);

[System.Security.SecurityCritical]
protected bool WriteEvent (ref System.Diagnostics.Eventing.EventDescriptor eventDescriptor, int dataCount, IntPtr data);

[<System.Security.SecurityCritical>]
member this.WriteEvent : EventDescriptor * int * nativeint -> bool

Protected Function WriteEvent (ByRef eventDescriptor As EventDescriptor, dataCount As Integer, data As IntPtr) As Boolean

Paramètres

eventDescriptor: EventDescriptor

Instance de EventDescriptor qui identifie l'événement à écrire.

dataCount: Int32

Taille des données de l'événement sur lesquelles le paramètre data pointe. La taille maximale des données de l'événement est limitée à 64 Ko, moins la taille des en-têtes de l'é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.

data: IntPtr
nativeint

Pointeur sur les données de l'événement à écrire.

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

Remarques

S’applique à

EventProvider.WriteEvent Méthode

Définition

Surcharges

Remarques

WriteEvent(EventDescriptor, Object[])

Paramètres

Retours

Exceptions

Exemples

Remarques

S’applique à

WriteEvent(EventDescriptor, String)

Paramètres

Retours

Exceptions

Exemples

Remarques

S’applique à

WriteEvent(EventDescriptor, Int32, IntPtr)

Paramètres

Retours

Remarques

S’applique à

Commentaires

Ressources supplémentaires