EventProvider.WriteEvent Methode

Definitie

Naamruimte:: System.Diagnostics.Eventing

Assembly:: System.Core.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee schrijft u een gebeurtenis.

Overloads

Name	Description
WriteEvent(EventDescriptor, Object[])	Hiermee schrijft u een gebeurtenis. De gebeurtenisgegevens worden opgegeven als een matrix met objecten.
WriteEvent(EventDescriptor, String)	Hiermee schrijft u een gebeurtenis. De gebeurtenisgegevens worden opgegeven als een tekenreeks.
WriteEvent(EventDescriptor, Int32, IntPtr)	Hiermee schrijft u een gebeurtenis. De gebeurtenisgegevens worden opgegeven als een blok geheugen.

Opmerkingen

Gebruik deze methoden als u een manifest gebruikt om uw gebeurtenissen te definiëren.

WriteEvent(EventDescriptor, Object[])

Hiermee schrijft u een gebeurtenis. De gebeurtenisgegevens worden opgegeven als een matrix met objecten.

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

Parameters

eventDescriptor: EventDescriptor

Een instantie van EventDescriptor die identificeert de gebeurtenis die moet worden geschreven.

eventPayload: Object[]

Een matrix met objecten die de gebeurtenisgegevens bevatten die moeten worden geschreven. Het object moet de volgorde hebben die is opgegeven in het manifest. De matrix is beperkt tot 32 objecten, waarvan slechts acht tekenreeksen mogen zijn. De maximale gegevensgrootte voor de gebeurtenis is beperkt tot 64 kB min de grootte van de gebeurtenisheaders. De gebeurtenisgrootte is kleiner als de buffergrootte van de sessie kleiner is en de sessie uitgebreide gegevensitems bevat met de gebeurtenis.

Deze parameter kan null zijn.

Retouren

Boolean

Is true als de gebeurtenis is geschreven; anders. false Als dit onwaar is, roept u de GetLastWriteEventError() methode aan om de oorzaak van de fout te bepalen.

Kenmerken: SecurityCriticalAttribute

Uitzonderingen

ArgumentException

De eventPayload parameter bevat te veel objecten of tekenreeksen.

Voorbeelden

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();

Opmerkingen

Als u de SetActivityId methode aanroept om een activiteits-id voor de gebeurtenis op te geven, haalt deze methode de id op uit de threadcontext en bevat deze bij de gebeurtenis.

Als het objecttype niet wordt ondersteund, schrijft de methode de waarde van de methode van het object Object.ToString in de nettolading. Zie de opmerkingen voor de EventProvider klasse voor een lijst met ondersteunde objecttypen.

Van toepassing op

WriteEvent(EventDescriptor, String)

Hiermee schrijft u een gebeurtenis. De gebeurtenisgegevens worden opgegeven als een tekenreeks.

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

Parameters

eventDescriptor: EventDescriptor

Een instantie van EventDescriptor die identificeert de gebeurtenis die moet worden geschreven.

data: String

De tekenreeks die moet worden geschreven als de gebeurtenisgegevens.

Retouren

Boolean

Is true als de gebeurtenis is geschreven; anders. false Als dit onwaar is, roept u de GetLastWriteEventError() methode aan om de oorzaak van de fout te bepalen.

Kenmerken: SecurityCriticalAttribute

Uitzonderingen

ArgumentException

Als data dat het is null.

Voorbeelden

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();

Opmerkingen

Als u de SetActivityId methode aanroept om een activiteits-id voor de gebeurtenis op te geven, haalt deze methode de id op uit de threadcontext en bevat deze bij de gebeurtenis.

De maximale tekenreekslengte is beperkt tot 64 kB min de grootte van de gebeurtenisheaders. De gebeurtenisgrootte is kleiner als de buffergrootte van de sessie kleiner is en de sessie uitgebreide gegevensitems bevat met de gebeurtenis.

Van toepassing op

WriteEvent(EventDescriptor, Int32, IntPtr)

Hiermee schrijft u een gebeurtenis. De gebeurtenisgegevens worden opgegeven als een blok geheugen.

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

Parameters

eventDescriptor: EventDescriptor

Een instantie van EventDescriptor die identificeert de gebeurtenis die moet worden geschreven.

dataCount: Int32

Grootte van de gebeurtenisgegevens waarnaar de data parameter verwijst. De maximale grootte van gebeurtenisgegevens is beperkt tot 64 kB min de grootte van de gebeurtenisheaders. De gebeurtenisgrootte is kleiner als de buffergrootte van de sessie kleiner is en de sessie uitgebreide gegevensitems bevat met de gebeurtenis.

data: IntPtr
nativeint

Wijs de gebeurtenisgegevens aan die moeten worden geschreven.

Retouren

Boolean

Is true als de gebeurtenis is geschreven; anders. false Als dit onwaar is, roept u de GetLastWriteEventError() methode aan om de oorzaak van de fout te bepalen.

Kenmerken: SecurityCriticalAttribute

Opmerkingen

Als u de SetActivityId methode aanroept om een activiteits-id voor de gebeurtenis op te geven, haalt deze methode de id op uit de threadcontext en bevat deze bij de gebeurtenis.

Van toepassing op

Feedback

Is deze pagina nuttig?