Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.

Tradução

Original

Este tópico ainda não foi avaliado como - Avalie este tópico

Método TraceSource.TraceEvent (TraceEventType, Int32, String)

.NET Framework 4.5

Outras versões

Grava os ouvintes de rastreamento em uma mensagem de evento de rastreamento de Listeners coleção usando o tipo de evento especificado, o identificador de evento e a mensagem.

Namespace: System.Diagnostics
Assembly: System (em System.dll)

Sintaxe

C++

[ConditionalAttribute("TRACE")]
public void TraceEvent(
	TraceEventType eventType,
	int id,
	string message
)

Parâmetros

eventType: Tipo: System.Diagnostics.TraceEventType
Um dos valores de enumeração que especifica o tipo de evento de dados de rastreamento.

id: Tipo: System.Int32
Um identificador numérico para o evento.

message: Tipo: System.String
A mensagem de rastreamento para gravar.

Exceções

Exceção	Condição
ObjectDisposedException	Foi feita uma tentativa para rastrear um evento durante a finalização.

Comentários

O TraceEvent método destina-se a eventos de rastreamento que podem ser processados automaticamente pelas ferramentas. Por exemplo, uma ferramenta de monitoramento pode notificar um administrador se um evento específico é rastreado por uma fonte específica.

O TraceEvent chamadas de método de ShouldTrace método da SourceSwitch objeto retornado pela Switch propriedade. Se ShouldTrace retorna true, TraceEvent chama o correspondente TraceEvent método de cada ouvinte. Caso contrário, TraceEvent retorna sem chamar os métodos dos ouvintes.

O conteúdo de rastreamento é específico do ouvinte. Se o método não é substituído pela implementação do ouvinte, a saída padrão é o nome da fonte de rastreamento, sua identidade numérica, o tipo de evento e a mensagem. Conteúdo adicional de rastreamento depende do ouvinte TraceOutputOptions o valor da propriedade.

Observação
O EventLogTraceListener objeto está limitado a um máximo id valor de 65.535. Se a id valor especificado é maior do que 65.535, o EventLogTraceListener objeto usa 65.535.

Exemplos

O exemplo de código a seguir mostra o uso da TraceEvent(TraceEventType, Int32) método para passar de um evento de rastreamento para os ouvintes. Este exemplo de código é parte de um exemplo maior fornecido para a classe TraceSource.


// Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found");

Informações sobre versão

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Plataformas

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte .Requisitos de sistema do NET Framework.

Consulte também

Referência

TraceSource Classe

Sobrecargas TraceEvent

Namespace System.Diagnostics

Isso foi útil para você? Sim Não

Impreciso

Sem profundidade suficiente

Mais exemplos de código são necessários

A tradução precisa ser aprimorada

(1500 caracteres restantes)

Contribuições da comunidade

ADICIONAR