DelimitedListTraceListener.TraceEvent 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 informações de rastreamento de evento em um 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. |
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);
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 usado para identificar a saída, geralmente o nome do aplicativo que gerou o evento de rastreamento.
- eventType
- TraceEventType
Um dos valores TraceEventType que especifica o tipo de evento que causou o rastreamento.
- id
- Int32
Um identificador numérico do evento.
- message
- String
A mensagem de rastreamento a ser gravada no fluxo ou arquivo de saída.
Comentários
Os valores dos source
parâmetros , eventType
e id
são gravados como um cabeçalho, seguidos pelos message
dados. Os eventCache
dados são gravados como um rodapé cujo conteúdo depende do valor da TraceOutputOptions propriedade.
Importante
O TraceEvent método não se destina a ser chamado pelo código do aplicativo. Ele é chamado por métodos das Debugclasses , Tracee TraceSource para gravar dados de rastreamento.
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);
public override void TraceEvent (System.Diagnostics.TraceEventCache? eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, string? format, params 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 usado para identificar a saída, geralmente o nome do aplicativo que gerou o evento de rastreamento.
- eventType
- TraceEventType
Um dos valores TraceEventType que especifica o tipo de evento que causou o rastreamento.
- 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 que contém zero ou mais objetos a serem formatados.
Comentários
Os valores dos source
parâmetros , eventType
e id
são gravados como um cabeçalho. A args
matriz de objetos é convertida em uma cadeia de caracteres usando o String.Format(String, Object[]) método , passando a format
cadeia de caracteres e args
a matriz para formatar a cadeia de caracteres como a parte da mensagem do rastreamento. Os eventCache
dados são gravados como um rodapé cujo conteúdo depende do valor da TraceOutputOptions propriedade.
Importante
O TraceEvent método não se destina a ser chamado pelo código do aplicativo. Ele é chamado por métodos das Debugclasses , Tracee TraceSource para gravar dados de rastreamento.