EventSource.WriteEvent Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Grava um evento usando o identificador de evento e argumentos opcionais fornecidos.
Sobrecargas
WriteEvent(Int32, String, String, String) |
Grava um evento usando o identificador de evento e os argumentos de cadeia de caractere fornecidos. |
WriteEvent(Int32, String, Int32, Int32) |
Grava um evento usando o identificador de evento fornecido e os argumentos. |
WriteEvent(Int32, Int64, Int64, Int64) |
Grava um evento usando o identificador de evento fornecido e os argumentos 64 bits. |
WriteEvent(Int32, Int32, Int32, Int32) |
Grava um evento usando o identificador de evento e os argumentos inteiros de 32 bits fornecidos. |
WriteEvent(Int32, String, String) |
Grava um evento usando o identificador de evento e os argumentos de cadeia de caractere fornecidos. |
WriteEvent(Int32, String, Int64) |
Grava um evento usando o identificador de evento fornecido e os argumentos. |
WriteEvent(Int32, String, Int32) |
Grava um evento usando o identificador de evento fornecido e os argumentos. |
WriteEvent(Int32, Int64, String) |
Grava um evento usando o identificador de evento fornecido e argumentos inteiros de 64 bits e cadeia de caracteres fornecidos. |
WriteEvent(Int32, Int64, Int64) |
Grava um evento usando o identificador de evento fornecido e os argumentos 64 bits. |
WriteEvent(Int32, Int32, Int32) |
Grava um evento usando o identificador de evento e os argumentos inteiros de 32 bits fornecidos. |
WriteEvent(Int32, Int32, String) |
Grava um evento usando o identificador de evento fornecido e argumentos inteiros de 32 bits e cadeia de caracteres fornecidos. |
WriteEvent(Int32, String) |
Grava um evento usando o identificador de evento e o argumentos de cadeia de caractere fornecidos. |
WriteEvent(Int32, Object[]) |
Grava um evento usando o identificador de evento fornecido e a matriz de argumentos. |
WriteEvent(Int32, Int64) |
Grava um evento usando o identificador de evento e o argumento inteiro de 64 bits fornecidos. |
WriteEvent(Int32, Int32) |
Grava um evento usando o identificador de evento e o argumento inteiro de 32 bits fornecidos. |
WriteEvent(Int32, EventSource+EventSourcePrimitive[]) |
Grava um evento usando o identificador de evento fornecido e um número variável de primitivos de origem do evento. |
WriteEvent(Int32, Byte[]) |
Grava um evento usando o identificador de evento e o argumento de matriz de bytes fornecidos. |
WriteEvent(Int32) |
Grava um evento usando o identificador de evento fornecido. |
WriteEvent(Int32, Int64, Byte[]) |
Grava os dados de evento usando o identificador especificado e inteiro de 64 bits e argumentos da matriz de bytes. |
Comentários
O WriteEvent
método fornece sobrecargas com combinações de argumentos de cadeia de caracteres e inteiros. Se nenhuma dessas combinações corresponder aos parâmetros da chamada, o compilador usará a EventSource.WriteEvent(Int32, Object[]) sobrecarga, que é consideravelmente mais lenta do que as outras sobrecargas. Consulte a página de sobrecarga para obter detalhes.
Em todos os casos, o eventid
parâmetro deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
Você também pode criar uma sobrecarga personalizada usando o WriteEventCore método .
Importante
Parâmetros de evento com um tipo de string
não devem incluir \0
caracteres. Eles são caracteres sem suporte e podem causar problemas para analisadores do conteúdo do evento.
WriteEvent(Int32, String, String, String)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento e os argumentos de cadeia de caractere fornecidos.
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);
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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- String
Um argumento de cadeia de caracteres.
- arg2
- String
Um argumento de cadeia de caracteres.
- arg3
- String
Um argumento de cadeia de caracteres.
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32, String, Int32, Int32)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento fornecido e os argumentos.
protected:
void WriteEvent(int eventId, System::String ^ arg1, int arg2, int arg3);
protected void WriteEvent (int eventId, 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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- String
Um argumento de cadeia de caracteres.
- arg2
- Int32
Um argumento inteiro de 32 bits.
- arg3
- Int32
Um argumento inteiro de 32 bits.
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32, Int64, Int64, Int64)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento fornecido e os argumentos 64 bits.
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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- Int64
Um argumento inteiro de 64 bits.
- arg2
- Int64
Um argumento inteiro de 64 bits.
- arg3
- Int64
Um argumento inteiro de 64 bits.
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32, Int32, Int32, Int32)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento e os argumentos inteiros de 32 bits fornecidos.
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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- Int32
Um argumento inteiro.
- arg2
- Int32
Um argumento inteiro.
- arg3
- Int32
Um argumento inteiro.
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32, String, String)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento e os argumentos de cadeia de caractere fornecidos.
protected:
void WriteEvent(int eventId, System::String ^ arg1, System::String ^ arg2);
protected void WriteEvent (int eventId, string arg1, 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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- String
Um argumento de cadeia de caracteres.
- arg2
- String
Um argumento de cadeia de caracteres.
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32, String, Int64)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento fornecido e os argumentos.
protected:
void WriteEvent(int eventId, System::String ^ arg1, long arg2);
protected void WriteEvent (int eventId, 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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- String
Um argumento de cadeia de caracteres.
- arg2
- Int64
Um argumento inteiro de 64 bits.
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32, String, Int32)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento fornecido e os argumentos.
protected:
void WriteEvent(int eventId, System::String ^ arg1, int arg2);
protected void WriteEvent (int eventId, 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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- String
Um argumento de cadeia de caracteres.
- arg2
- Int32
Um argumento inteiro de 32 bits.
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32, Int64, String)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento fornecido e argumentos inteiros de 64 bits e cadeia de caracteres fornecidos.
protected:
void WriteEvent(int eventId, long arg1, System::String ^ arg2);
protected void WriteEvent (int eventId, long arg1, 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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- Int64
Um argumento inteiro de 64 bits.
- arg2
- String
Um argumento de cadeia de caracteres.
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(Int64 arg1, string arg2)
{
base.WriteEvent(2, arg1, arg2);
}
Aplica-se a
WriteEvent(Int32, Int64, Int64)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento fornecido e os argumentos 64 bits.
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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- Int64
Um argumento inteiro de 64 bits.
- arg2
- Int64
Um argumento inteiro de 64 bits.
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32, Int32, Int32)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento e os argumentos inteiros de 32 bits fornecidos.
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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- Int32
Um argumento inteiro.
- arg2
- Int32
Um argumento inteiro.
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(int arg1, int arg2, int arg3)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32, Int32, String)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento fornecido e argumentos inteiros de 32 bits e cadeia de caracteres fornecidos.
protected:
void WriteEvent(int eventId, int arg1, System::String ^ arg2);
protected void WriteEvent (int eventId, int arg1, 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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- Int32
Um argumento inteiro de 32 bits.
- arg2
- String
Um argumento de cadeia de caracteres.
Aplica-se a
WriteEvent(Int32, String)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento e o argumentos de cadeia de caractere fornecidos.
protected:
void WriteEvent(int eventId, System::String ^ arg1);
protected void WriteEvent (int eventId, 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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- String
Um argumento de cadeia de caracteres.
Exemplos
O exemplo a seguir mostra como usar essa sobrecarga de método para gravar um evento. Este exemplo de código faz parte de um exemplo maior fornecido para a EventSource classe .
[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
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32, Object[])
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento fornecido e a matriz de argumentos.
protected:
void WriteEvent(int eventId, ... cli::array <System::Object ^> ^ args);
protected void WriteEvent (int eventId, params 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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- args
- Object[]
Uma matriz de objetos.
Comentários
Por padrão, o compilador chamará essa sobrecarga se os parâmetros da chamada não corresponderem a uma das outras sobrecargas de método. Essa sobrecarga é muito mais lenta do que as outras sobrecargas, pois faz o seguinte:
Ele aloca uma matriz para manter o argumento de variável.
Ele converte cada parâmetro em um objeto (o que causa alocações para tipos primitivos).
Ele atribui esses objetos à matriz.
Ele chama a função , que determina o tipo de cada argumento para que possa ser serializada para ETW.
A alta sobrecarga para essa sobrecarga não é significativa ao rastrear eventos de baixo volume, pois o método é usado somente quando o provedor está habilitado. No entanto, para eventos de alto volume, a sobrecarga de desempenho pode ser significativa. Você pode evitar usar EventSource.WriteEvent para cargas de alto volume criando uma sobrecarga nova e mais rápida com o WriteEventCore método .
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32, Int64)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento e o argumento inteiro de 64 bits fornecidos.
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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- Int64
Um argumento inteiro de 64 bits.
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32, Int32)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento e o argumento inteiro de 32 bits fornecidos.
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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- Int32
Um argumento inteiro.
Exemplos
O exemplo a seguir mostra como usar essa sobrecarga de método para gravar um evento. Este exemplo de código faz parte de um exemplo maior fornecido para a EventSource classe .
[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
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(int arg1)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32, EventSource+EventSourcePrimitive[])
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento fornecido e um número variável de primitivos de origem do evento.
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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
Os primitivos de origem do evento.
Comentários
Este é um auxiliar varargs para escrever um evento. Ele cria uma matriz e faz a caixa de todos os argumentos para que seja relativamente ineficiente e só deve ser usado para eventos relativamente raros (por exemplo, menos de 100 por segundo). Se suas taxas forem mais rápidas do que isso, use WriteEventCore(Int32, Int32, EventSource+EventData*) para criar auxiliares rápidos para sua assinatura de método específica. Mesmo que você use isso para eventos raros, essa chamada deve ser protegida por um IsEnabled() marcar para que a chamada varargs não seja feita quando o EventSource não estiver ativo.
Aplica-se a
WriteEvent(Int32, Byte[])
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento e o argumento de matriz de bytes fornecidos.
protected:
void WriteEvent(int eventId, cli::array <System::Byte> ^ arg1);
protected void WriteEvent (int eventId, 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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- Byte[]
Um argumento de matriz de bytes.
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(byte[] arg1)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32)
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava um evento usando o identificador de evento fornecido.
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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
Exemplos
O exemplo a seguir mostra como usar essa sobrecarga de método para gravar um evento. Este exemplo de código faz parte de um exemplo maior fornecido para a EventSource classe .
[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
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(string arg1)
{
base.WriteEvent(2, arg1);
}
Aplica-se a
WriteEvent(Int32, Int64, Byte[])
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
- Origem:
- EventSource.cs
Grava os dados de evento usando o identificador especificado e inteiro de 64 bits e argumentos da matriz de bytes.
protected:
void WriteEvent(int eventId, long arg1, cli::array <System::Byte> ^ arg2);
protected void WriteEvent (int eventId, long arg1, 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
O identificador de evento. Esse valor deve estar entre 0 e 65535.
- arg1
- Int64
Um argumento inteiro de 64 bits.
- arg2
- Byte[]
Um argumento de matriz de bytes.
Comentários
eventid
deve ser maior que 0 ou menor que 65535 ou erros podem ocorrer na operação. Se ocorrerem erros, você poderá obter mais informações sobre a origem do erro verificando o fluxo de saída do depurador, se você tiver um depurador anexado aos eventos de disparo do processo. Você também pode procurar erros relatados no fluxo de eventos etw, se você tiver um ouvinte ETW na origem do evento em que o erro ocorre.
Quando você implementa um método identificado como um evento ETW em uma EventSourceclasse derivada de . Você deve chamar o método de classe WriteEvent base passando o EventId e os mesmos argumentos que o método implementado semelhante ao exemplo a seguir.
[Event(2, Level = EventLevel.Informational)]
public void Info1(Int64 arg1, Byte[] arg2)
{
base.WriteEvent(2, arg1, arg2);
}