FileLogTraceListener.TraceEvent Método

Definição

Namespace:

Microsoft.VisualBasic.Logging

Assembly:

Microsoft.VisualBasic.Forms.dll

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

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType

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

• TraceListener
• FullLogFileName
• TraceOutputOptions
• TraceEventCache
• TraceEventType