TraceSource.TraceEvent Método

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Grava uma mensagem de evento de rastreamento para os ouvintes de rastreamento na coleção Listeners.

Sobrecargas

TraceEvent(TraceEventType, Int32)	Grava uma mensagem de evento de rastreamento para os ouvintes de rastreamento na coleção Listeners usando o tipo de evento e o identificador de evento especificados.
TraceEvent(TraceEventType, Int32, String)	Grava uma mensagem de evento de rastreamento para os ouvintes de rastreamento na coleção Listeners usando o tipo de evento, o identificador de evento e a mensagem especificados.
TraceEvent(TraceEventType, Int32, String, Object[])	Grava um evento de rastreamento nos ouvintes de rastreamento na coleção Listeners usando o tipo de evento, o identificador de evento e a matriz e o formato do argumento especificados.

TraceEvent(TraceEventType, Int32)

Origem:

TraceSource.cs

Grava uma mensagem de evento de rastreamento para os ouvintes de rastreamento na coleção Listeners usando o tipo de evento e o identificador de evento especificados.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer)

Parâmetros

eventType

TraceEventType

Um dos valores de enumeração que especifica o tipo de evento dos dados de rastreamento.

id

Int32

Um identificador numérico para o evento.

Atributos

ConditionalAttribute

Exceções

ObjectDisposedException

Foi feita uma tentativa de rastrear um evento durante a finalização.

Exemplos

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

ts.TraceEvent(TraceEventType.Warning, 1);

ts.TraceEvent(TraceEventType.Warning, 1)

Comentários

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

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

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

Nota

O objeto EventLogTraceListener é limitado a um valor máximo de id de 65.535. Se o valor de id especificado for maior que 65.535, o EventLogTraceListener usará 65.535.

TraceEvent(TraceEventType, Int32, String)

Origem:

TraceSource.cs

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

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? message);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)

Parâmetros

eventType

TraceEventType

Um dos valores de enumeração que especifica o tipo de evento dos dados de rastreamento.

id

Int32

Um identificador numérico para o evento.

message

String

A mensagem de rastreamento a ser gravada.

Atributos

ConditionalAttribute

Exceções

ObjectDisposedException

Foi feita uma tentativa de rastrear um evento durante a finalização.

Exemplos

O exemplo de código a seguir mostra o uso do método TraceEvent(TraceEventType, Int32) para passar um evento de rastreamento para os ouvintes. Este exemplo de código faz 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");

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

Comentários

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

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

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

Nota

O objeto EventLogTraceListener é limitado a um valor máximo de id de 65.535. Se o valor de id especificado for maior que 65.535, o objeto EventLogTraceListener usará 65.535.

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

Origem:

TraceSource.cs

Grava um evento de rastreamento nos ouvintes de rastreamento na coleção Listeners usando o tipo de evento, o identificador de evento e a matriz e o formato do argumento especificados.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);

[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unit

Public Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Parâmetros

eventType

TraceEventType

Um dos valores de enumeração que especifica o tipo de evento dos dados de rastreamento.

id

Int32

Um identificador numérico para o evento.

format

String

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

args

Object[]

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

Atributos

ConditionalAttribute

Exceções

ArgumentNullException

format é null.

FormatException

format é inválido.

-ou-

O número que indica um argumento a ser formatado é menor que zero ou maior ou igual ao número de objetos especificados a serem formatados.

ObjectDisposedException

Foi feita uma tentativa de rastrear um evento durante a finalização.

Exemplos

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

// Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test");

' Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test")

Comentários

Para obter mais informações sobre o parâmetro format, consulte de Formatação Composta.

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

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

O conteúdo do rastreamento é específico do ouvinte. O método de TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) padrão grava o nome de origem, o tipo de evento e a identidade numérica no cabeçalho de rastreamento e, em seguida, chama o método String.Format(IFormatProvider, String, Object[]), passando a cadeia de caracteres format e args matriz e usando a propriedade CultureInfo.InvariantCulture para formatar a cadeia de caracteres como a saída da mensagem.

Nota

O objeto EventLogTraceListener é limitado a um valor máximo de id de 65.535. Se o valor de id especificado for maior que 65.535, o objeto EventLogTraceListener usará 65.535.

Confira também

• de Formatação Composta
• cadeias de caracteres de formato numérico padrão
• cadeias de caracteres de formato numérico personalizado
• cadeias de caracteres de formato datetime padrão
• cadeias de caracteres de formato datetime personalizadas
• cadeias de caracteres de formato de enumeração
• tipos de formatação no .NET