EventSource.WriteEvent Método

Definición

Espacio de nombres:

System.Diagnostics.Tracing

Ensamblado:

System.Diagnostics.Tracing.dll

Escribe un evento con el identificador de eventos y los argumentos opcionales especificados.

Sobrecargas

WriteEvent(Int32, String, String, String)	Escribe un evento con el identificador de eventos y los argumentos de cadena especificados.
WriteEvent(Int32, String, Int32, Int32)	Escribe un evento con el identificador de eventos y los argumentos especificados.
WriteEvent(Int32, Int64, Int64, Int64)	Escribe un evento con el identificador de eventos y los argumentos de 64 bits especificados.
WriteEvent(Int32, Int32, Int32, Int32)	Escribe un evento con el identificador de eventos y los argumentos enteros de 32 bits especificados.
WriteEvent(Int32, String, String)	Escribe un evento con el identificador de eventos y los argumentos de cadena especificados.
WriteEvent(Int32, String, Int64)	Escribe un evento con el identificador de eventos y los argumentos especificados.
WriteEvent(Int32, String, Int32)	Escribe un evento con el identificador de eventos y los argumentos especificados.
WriteEvent(Int32, Int64, String)	Escribe un evento con el identificador de eventos y los argumentos de cadena y enteros de 64 bits especificados.
WriteEvent(Int32, Int64, Int64)	Escribe un evento con el identificador de eventos y los argumentos de 64 bits especificados.
WriteEvent(Int32, Int32, Int32)	Escribe un evento con el identificador de eventos y los argumentos enteros de 32 bits especificados.
WriteEvent(Int32, Int32, String)	Escribe un evento con el identificador de eventos y los argumentos de cadena y enteros de 32 bits especificados.
WriteEvent(Int32, String)	Escribe un evento con el identificador de eventos y el argumento de cadena especificados.
WriteEvent(Int32, Object[])	Escribe un evento con el identificador de eventos y la matriz de argumentos especificados.
WriteEvent(Int32, Int64)	Escribe un evento con el identificador de eventos y el argumento entero de 64 bits especificados.
WriteEvent(Int32, Int32)	Escribe un evento con el identificador de eventos y el argumento entero de 32 bits especificados.
WriteEvent(Int32, EventSource+EventSourcePrimitive[])	Escribe un evento mediante el identificador de evento proporcionado y un número variable de primitivos de origen de eventos.
WriteEvent(Int32, Byte[])	Escribe un evento con el identificador de eventos y el argumento de matriz de bytes especificados.
WriteEvent(Int32)	Escribe un evento con el identificador de eventos proporcionado.
WriteEvent(Int32, Int64, Byte[])	Escribe los datos del evento con el identificador y los argumentos de matriz de bytes y enteros de 64 bits especificados.

Comentarios

El WriteEvent método proporciona sobrecargas con combinaciones de argumentos de cadena e enteros. Si ninguna de estas combinaciones coincide con los parámetros de la llamada, el compilador usa la EventSource.WriteEvent(Int32, Object[]) sobrecarga, que es considerablemente más lenta que las demás sobrecargas. Consulte la página de sobrecarga para obtener más información.

En todos los casos, el eventid parámetro debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Al implementar un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando los EventId argumentos y los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

También puede crear una sobrecarga personalizada mediante el WriteEventCore método .

Importante

Los parámetros de evento con un tipo de string no deben incluir \0 caracteres. Son caracteres no admitidos y pueden causar problemas para los analizadores de la carga del evento.

WriteEvent(Int32, String, String, String)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y los argumentos de cadena especificados.

protected:
 void WriteEvent(int eventId, System::String ^ arg1, System::String ^ arg2, System::String ^ arg3);

protected void WriteEvent (int eventId, string? arg1, string? arg2, string? arg3);

member this.WriteEvent : int * string * string * string -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As String, arg3 As String)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

String

Argumento de cadena.

arg2

String

Argumento de cadena.

arg3

String

Argumento de cadena.

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Al implementar un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando los EventId argumentos y los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32, String, Int32, Int32)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y los argumentos especificados.

protected:
 void WriteEvent(int eventId, System::String ^ arg1, int arg2, int arg3);

protected void WriteEvent (int eventId, string? arg1, int arg2, int arg3);

member this.WriteEvent : int * string * int * int -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As Integer, arg3 As Integer)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

String

Argumento de cadena.

arg2

Int32

Argumento de tipo entero de 32 bits.

arg3

Int32

Argumento de tipo entero de 32 bits.

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Al implementar un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando los EventId argumentos y los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32, Int64, Int64, Int64)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y los argumentos de 64 bits especificados.

protected:
 void WriteEvent(int eventId, long arg1, long arg2, long arg3);

protected void WriteEvent (int eventId, long arg1, long arg2, long arg3);

member this.WriteEvent : int * int64 * int64 * int64 -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As Long, arg2 As Long, arg3 As Long)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

Int64

Argumento de tipo entero de 64 bits.

arg2

Int64

Argumento de tipo entero de 64 bits.

arg3

Int64

Argumento de tipo entero de 64 bits.

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Al implementar un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando los EventId argumentos y los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32, Int32, Int32, Int32)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y los argumentos enteros de 32 bits especificados.

protected:
 void WriteEvent(int eventId, int arg1, int arg2, int arg3);

protected void WriteEvent (int eventId, int arg1, int arg2, int arg3);

member this.WriteEvent : int * int * int * int -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As Integer, arg2 As Integer, arg3 As Integer)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

Int32

Argumento de tipo entero.

arg2

Int32

Argumento de tipo entero.

arg3

Int32

Argumento de tipo entero.

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Al implementar un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando los EventId argumentos y los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32, String, String)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y los argumentos de cadena especificados.

protected:
 void WriteEvent(int eventId, System::String ^ arg1, System::String ^ arg2);

protected void WriteEvent (int eventId, string? arg1, string? arg2);

member this.WriteEvent : int * string * string -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As String)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

String

Argumento de cadena.

arg2

String

Argumento de cadena.

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Al implementar un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando los EventId argumentos y los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32, String, Int64)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y los argumentos especificados.

protected:
 void WriteEvent(int eventId, System::String ^ arg1, long arg2);

protected void WriteEvent (int eventId, string? arg1, long arg2);

member this.WriteEvent : int * string * int64 -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As Long)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

String

Argumento de cadena.

arg2

Int64

Argumento de tipo entero de 64 bits.

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Cuando se implementa un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando y EventId los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32, String, Int32)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y los argumentos especificados.

protected:
 void WriteEvent(int eventId, System::String ^ arg1, int arg2);

protected void WriteEvent (int eventId, string? arg1, int arg2);

member this.WriteEvent : int * string * int -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As String, arg2 As Integer)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

String

Argumento de cadena.

arg2

Int32

Argumento de tipo entero de 32 bits.

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Cuando se implementa un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando y EventId los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32, Int64, String)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y los argumentos de cadena y enteros de 64 bits especificados.

protected:
 void WriteEvent(int eventId, long arg1, System::String ^ arg2);

protected void WriteEvent (int eventId, long arg1, string? arg2);

member this.WriteEvent : int * int64 * string -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As Long, arg2 As String)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

Int64

Argumento de tipo entero de 64 bits.

arg2

String

Argumento de cadena.

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Cuando se implementa un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando y EventId los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(Int64 arg1, string arg2)
{
    base.WriteEvent(2, arg1, arg2);
}

WriteEvent(Int32, Int64, Int64)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y los argumentos de 64 bits especificados.

protected:
 void WriteEvent(int eventId, long arg1, long arg2);

protected void WriteEvent (int eventId, long arg1, long arg2);

member this.WriteEvent : int * int64 * int64 -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As Long, arg2 As Long)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

Int64

Argumento de tipo entero de 64 bits.

arg2

Int64

Argumento de tipo entero de 64 bits.

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Cuando se implementa un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando y EventId los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32, Int32, Int32)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y los argumentos enteros de 32 bits especificados.

protected:
 void WriteEvent(int eventId, int arg1, int arg2);

protected void WriteEvent (int eventId, int arg1, int arg2);

member this.WriteEvent : int * int * int -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As Integer, arg2 As Integer)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

Int32

Argumento de tipo entero.

arg2

Int32

Argumento de tipo entero.

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Cuando se implementa un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando y EventId los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(int arg1, int arg2, int arg3)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32, Int32, String)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y los argumentos de cadena y enteros de 32 bits especificados.

protected:
 void WriteEvent(int eventId, int arg1, System::String ^ arg2);

protected void WriteEvent (int eventId, int arg1, string? arg2);

member this.WriteEvent : int * int * string -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As Integer, arg2 As String)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

Int32

Argumento de tipo entero de 32 bits.

arg2

String

Argumento de cadena.

WriteEvent(Int32, String)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y el argumento de cadena especificados.

protected:
 void WriteEvent(int eventId, System::String ^ arg1);

protected void WriteEvent (int eventId, string? arg1);

member this.WriteEvent : int * string -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As String)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

String

Argumento de cadena.

Ejemplos

En el ejemplo siguiente se muestra cómo usar esta sobrecarga de método para escribir un evento. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase EventSource.

[Event(1, Message = "Application Failure: {0}", Level = EventLevel.Error, Keywords = Keywords.Diagnostic)]
public void Failure(string message) { WriteEvent(1, message); }

<[Event](1, Message:="Application Failure: {0}", Level:=EventLevel.Error, Keywords:=Keywords.Diagnostic)> _
Public Sub Failure(ByVal message As String)
    WriteEvent(1, message)
End Sub

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Cuando se implementa un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando y EventId los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32, Object[])

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y la matriz de argumentos especificados.

protected:
 void WriteEvent(int eventId, ... cli::array <System::Object ^> ^ args);

protected void WriteEvent (int eventId, params object?[] args);

member this.WriteEvent : int * obj[] -> unit

Protected Sub WriteEvent (eventId As Integer, ParamArray args As Object())

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

args

Object[]

Matriz de objetos.

Comentarios

De forma predeterminada, el compilador llama a esta sobrecarga si los parámetros de la llamada no coinciden con una de las otras sobrecargas del método. Esta sobrecarga es mucho más lenta que las demás sobrecargas, ya que hace lo siguiente:

1. Asigna una matriz para contener el argumento de variable.

2. Convierte cada parámetro en un objeto (lo que provoca asignaciones para tipos primitivos).

3. Asigna estos objetos a la matriz.

4. Llama a la función , que luego determina el tipo de cada argumento para que se pueda serializar para ETW.

La sobrecarga elevada de esta sobrecarga no es significativa cuando se trazan eventos de bajo volumen, ya que el método solo se usa cuando el proveedor está habilitado. Sin embargo, para los eventos de gran volumen, la sobrecarga de rendimiento puede ser significativa. Puede evitar el uso EventSource.WriteEvent de cargas de gran volumen mediante la creación de una sobrecarga nueva y más rápida con el WriteEventCore método .

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Cuando se implementa un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando y EventId los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32, Int64)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y el argumento entero de 64 bits especificados.

protected:
 void WriteEvent(int eventId, long arg1);

protected void WriteEvent (int eventId, long arg1);

member this.WriteEvent : int * int64 -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As Long)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

Int64

Argumento de tipo entero de 64 bits.

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Cuando se implementa un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando y EventId los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32, Int32)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y el argumento entero de 32 bits especificados.

protected:
 void WriteEvent(int eventId, int arg1);

protected void WriteEvent (int eventId, int arg1);

member this.WriteEvent : int * int -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As Integer)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

Int32

Argumento de tipo entero.

Ejemplos

En el ejemplo siguiente se muestra cómo usar esta sobrecarga de método para escribir un evento. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase EventSource.

[Event(4, Opcode = EventOpcode.Stop, Task = Tasks.Page, Keywords = Keywords.Page, Level = EventLevel.Informational)]
public void PageStop(int ID) { if (IsEnabled()) WriteEvent(4, ID); }

<[Event](4, Opcode:=EventOpcode.Stop, Task:=Tasks.Page, Keywords:=Keywords.Page, Level:=EventLevel.Informational)> _
Public Sub PageStop(ByVal ID As Integer)
    If IsEnabled() Then
        WriteEvent(4, ID)
    End If
End Sub

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Cuando se implementa un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando y EventId los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(int  arg1)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32, EventSource+EventSourcePrimitive[])

Source:

EventSource.cs

Escribe un evento mediante el identificador de evento proporcionado y un número variable de primitivos de origen de eventos.

protected:
 void WriteEvent(int eventId, ... cli::array <System::Diagnostics::Tracing::EventSource::EventSourcePrimitive> ^ args);

protected void WriteEvent (int eventId, params System.Diagnostics.Tracing.EventSource.EventSourcePrimitive[] args);

member this.WriteEvent : int * System.Diagnostics.Tracing.EventSource.EventSourcePrimitive[] -> unit

Protected Sub WriteEvent (eventId As Integer, ParamArray args As EventSource.EventSourcePrimitive())

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

args

EventSource.EventSourcePrimitive[]

Primitivos de origen del evento.

Comentarios

Se trata de un asistente varargs para escribir un evento. Crea una matriz y un cuadro todos los argumentos, por lo que es relativamente ineficaz y solo se debe usar para eventos relativamente raros (por ejemplo, menos de 100 por segundo). Si las tarifas son más rápidas que eso, use WriteEventCore(Int32, Int32, EventSource+EventData*) para crear asistentes rápidos para la firma de método determinada. Incluso si usa esto para eventos poco frecuentes, esta llamada debe protegerse mediante una IsEnabled() comprobación para que la llamada varargs no se realice cuando EventSource no esté activo.

WriteEvent(Int32, Byte[])

Source:

EventSource.cs

Escribe un evento con el identificador de eventos y el argumento de matriz de bytes especificados.

protected:
 void WriteEvent(int eventId, cli::array <System::Byte> ^ arg1);

protected void WriteEvent (int eventId, byte[]? arg1);

member this.WriteEvent : int * byte[] -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As Byte())

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

Byte[]

Argumento de matriz de bytes.

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Al implementar un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando los EventId argumentos y los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(byte[] arg1)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32)

Source:

EventSource.cs

Escribe un evento con el identificador de eventos proporcionado.

protected:
 void WriteEvent(int eventId);

protected void WriteEvent (int eventId);

member this.WriteEvent : int -> unit

Protected Sub WriteEvent (eventId As Integer)

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

Ejemplos

En el ejemplo siguiente se muestra cómo usar esta sobrecarga de método para escribir un evento. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase EventSource.

[Event(1, Message = "Application Failure: {0}", Level = EventLevel.Error, Keywords = Keywords.Diagnostic)]
public void Failure(string message) { WriteEvent(1, message); }

<[Event](1, Message:="Application Failure: {0}", Level:=EventLevel.Error, Keywords:=Keywords.Diagnostic)> _
Public Sub Failure(ByVal message As String)
    WriteEvent(1, message)
End Sub

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Al implementar un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando los EventId argumentos y los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
    base.WriteEvent(2, arg1);
}

WriteEvent(Int32, Int64, Byte[])

Source:

EventSource.cs

Escribe los datos del evento con el identificador y los argumentos de matriz de bytes y enteros de 64 bits especificados.

protected:
 void WriteEvent(int eventId, long arg1, cli::array <System::Byte> ^ arg2);

protected void WriteEvent (int eventId, long arg1, byte[]? arg2);

member this.WriteEvent : int * int64 * byte[] -> unit

Protected Sub WriteEvent (eventId As Integer, arg1 As Long, arg2 As Byte())

Parámetros

eventId

Int32

Identificador de evento. Este valor debe estar comprendido entre 0 y 65535.

arg1

Int64

Argumento de tipo entero de 64 bits.

arg2

Byte[]

Argumento de matriz de bytes.

Comentarios

eventid debe ser mayor que 0 o menor que 65535 o se pueden producir errores en la operación. Si se producen errores, puede obtener más información sobre el origen del error comprobando el flujo de salida del depurador, si tiene un depurador asociado a los eventos de activación del proceso. You can also look for errors reported in the ETW event stream, if you have an ETW listener on the event source where the error occurs.

Al implementar un método que se identifica como un evento ETW en una EventSourceclase derivada de . Debe llamar al método de clase WriteEvent base pasando los EventId argumentos y los mismos argumentos que el método implementado similar al ejemplo siguiente.

[Event(2, Level = EventLevel.Informational)]
public void Info1(Int64 arg1, Byte[] arg2)
{
    base.WriteEvent(2, arg1, arg2);
}