Partilhar via


FileLogTraceListener.TraceEvent Método

Definição

Grava informações de rastreamento e de evento no fluxo ou arquivo de saída.

Sobrecargas

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Grava as informações de rastreamento, uma mensagem e informações de evento no fluxo ou arquivo de saída.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Grava informações de rastreamento, uma matriz de objetos formatada e informações de evento no fluxo ou arquivo de saída.

Comentários

TraceEvent os métodos não devem ser chamados pelo código do aplicativo. Esses métodos são chamados por membros das Debugclasses , Tracee TraceSource para gravar dados de rastreamento na saída.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Grava as informações de rastreamento, uma mensagem e informações de evento no fluxo ou arquivo de saída.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string message);
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, message As String)

Parâmetros

eventCache
TraceEventCache

Um objeto TraceEventCache que contém as informações atuais de ID de processo, ID de thread e rastreamento de pilha.

source
String

Um nome da origem de rastreamento que invocou esse método.

eventType
TraceEventType

Um dos valores de enumeração TraceEventType.

id
Int32

Um identificador numérico do evento.

message
String

Uma mensagem a ser gravada.

Comentários

Este método:

  1. Formata os dados e as informações de contexto para saída.

  2. Cria um novo arquivo de log, se necessário.

  3. Grava as informações no arquivo de log.

Para obter mais informações sobre como criar novos arquivos de log, consulte FullLogFileName.

Esta tabela lista os campos de saída na ordem em que eles aparecem. Os campos são delimitados pela cadeia de caracteres especificada Delimiter pela propriedade e são seguidos por um terminador de linha.

Campo Condição de saída Descrição
source Sempre. O valor de name.
severity Sempre. O nome enumeração-valor de eventType.
id Sempre. A representação da cadeia de caracteres de id.
message Sempre. O valor de message.
callStack Quando o Callstack sinalizador é definido na TraceOutputOptions propriedade . A Callstack propriedade de eventCache.
CorrelationID Quando o LogicalOperationStack sinalizador é definido na TraceOutputOptions propriedade . A ThreadId propriedade de eventCache.
DateTime Quando o DateTime sinalizador é definido na TraceOutputOptions propriedade . A representação de cadeia de caracteres da DateTime propriedade de eventCache. A cultura invariável é usada para a conversão de cadeia de caracteres.
ProcessID Quando o ProcessId sinalizador é definido na TraceOutputOptions propriedade . A representação de cadeia de caracteres da ProcessId propriedade de eventCache. A cultura invariável é usada para a conversão de cadeia de caracteres.
ThreadID Quando o ThreadId sinalizador é definido na TraceOutputOptions propriedade . A ThreadId propriedade de eventCache.
Timestamp Quando o Timestamp sinalizador é definido na TraceOutputOptions propriedade . A representação de cadeia de caracteres da Timestamp propriedade de eventCache. A cultura invariável é usada para a conversão de cadeia de caracteres.
HostName Quando a IncludeHostName propriedade é True. O nome do computador.

Confira também

Aplica-se a

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Grava informações de rastreamento, uma matriz de objetos formatada e informações de evento no fluxo ou arquivo de saída.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Parâmetros

eventCache
TraceEventCache

Um objeto TraceEventCache que contém as informações atuais de ID de processo, ID de thread e rastreamento de pilha.

source
String

Um nome da origem de rastreamento que invocou esse método.

eventType
TraceEventType

Um dos valores de enumeração TraceEventType.

id
Int32

Um identificador numérico do evento.

format
String

Uma cadeia de caracteres de formato que contém zero ou mais itens de formato, que correspondem aos objetos na matriz args.

args
Object[]

Uma matriz Object que contém zero ou mais objetos a serem formatados.

Comentários

Este método:

  1. Formata os dados e as informações de contexto para saída.

  2. Cria um novo arquivo de log, se necessário.

  3. Grava as informações no arquivo de log.

Para obter mais informações sobre como criar um novo arquivo de log, consulte FullLogFileName.

Esta tabela lista os campos de saída na ordem em que eles aparecem. Os campos são delimitados pela cadeia de caracteres especificada Delimiter pela propriedade e seguidos por um terminador de linha.

Campo Condição de saída Descrição
source Sempre O valor de name.
severity Sempre O nome enumeração-valor de eventType.
id Sempre A representação da cadeia de caracteres de id.
message Sempre Os dados em args formatados com a format cadeia de caracteres e usando a cultura invariável para conversões de cadeia de caracteres.
callStack Quando o Callstack sinalizador é definido na TraceOutputOptions propriedade . A Callstack propriedade de eventCache.
CorrelationID Quando o LogicalOperationStack sinalizador é definido na TraceOutputOptions propriedade . A ThreadId propriedade de eventCache.
DateTime Quando o DateTime sinalizador é definido na TraceOutputOptions propriedade . A representação de cadeia de caracteres da DateTime propriedade de eventCache. A cultura invariável é usada para a conversão de cadeia de caracteres.
ProcessID Quando o ProcessId sinalizador é definido na TraceOutputOptions propriedade . A representação de cadeia de caracteres da ProcessId propriedade de eventCache. A cultura invariável é usada para a conversão de cadeia de caracteres.
ThreadID Quando o ThreadId sinalizador é definido na TraceOutputOptions propriedade . A ThreadId propriedade de eventCache.
Timestamp Quando o Timestamp sinalizador é definido na TraceOutputOptions propriedade . A representação de cadeia de caracteres da Timestamp propriedade de eventCache. A cultura invariável é usada para a conversão de cadeia de caracteres.
HostName Quando a IncludeHostName propriedade é True. O nome do computador.

Confira também

Aplica-se a