FileLogTraceListener.TraceEvent Método

Definição

Namespace:

Microsoft.VisualBasic.Logging

Assembly:

Microsoft.VisualBasic.Forms.dll

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

Sobrecargas

Nome	Description
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Grava informações de rastreamento, uma mensagem e informações de evento no arquivo ou fluxo de saída.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Grava informações de rastreamento, uma matriz formatada de objetos e informações de evento no arquivo ou fluxo 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 do Debug, Tracee TraceSource classes para gravar dados de rastreamento na saída.

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

Origem:

FileLogTraceListener.vb

Grava informações de rastreamento, uma mensagem e informações de evento no arquivo ou fluxo 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 TraceEventCache objeto que contém a ID do processo atual, a ID do thread e as informações de rastreamento de pilha.

source

String

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

eventType

TraceEventType

Um dos valores de TraceEventType enumeração.

id

Int32

Um identificador numérico para o 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 de 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 da 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 da 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 da 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

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType

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

Origem:

FileLogTraceListener.vb

Grava informações de rastreamento, uma matriz formatada de objetos e informações de evento no arquivo ou fluxo 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 TraceEventCache objeto que contém a ID do processo atual, a ID do thread e as informações de rastreamento de pilha.

source

String

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

eventType

TraceEventType

Um dos valores de TraceEventType enumeração.

id

Int32

Um identificador numérico para o evento.

format

String

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

args

Object[]

Uma Object matriz 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 de 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 da 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 da 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 da 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

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType