EventProvider.WriteEvent Méthode

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

Nom	Description
WriteEvent(EventDescriptor, Object[])	Écrit un événement. Les données d’événement sont spécifiées sous la forme d’un tableau d’objets.
WriteEvent(EventDescriptor, String)	Écrit un événement. Les données d’événement sont spécifiées sous forme de chaîne.
WriteEvent(EventDescriptor, Int32, IntPtr)	Écrit un événement. Les données d’événement sont spécifiées en tant que 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 sous la forme d’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 ce qui identifie l’événement à écrire.

eventPayload: Object[]

Tableau d’objets qui contiennent 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 seulement huit peuvent être des chaînes. La taille maximale des données de l’événement 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.

Ce paramètre peut être null.

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

Le eventPayload paramètre contient trop d’objets ou de 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 notes de la EventProvider classe.

S’applique à

WriteEvent(EventDescriptor, String)

Écrit un événement. Les données d’événement sont spécifiées sous forme de 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 ce qui identifie l’événement à écrire.

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

Attributs: SecurityCriticalAttribute

Exceptions

ArgumentException

Si data c’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 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 à

WriteEvent(EventDescriptor, Int32, IntPtr)

Écrit un événement. Les données d’événement sont spécifiées en tant que 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 ce qui identifie l’événement à écrire.

dataCount: Int32

Taille des données d’événement auxquelles pointe le data paramètre. La taille maximale des données d’événement 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.

data: IntPtr
nativeint

Pointeur vers les données d’événement à écrire.

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

Remarques

S’applique à

Commentaires

Cette page a-t-elle été utile ?