Compartilhar via


TraceSource.TraceEvent Método

Definição

Grava uma mensagem de evento de rastreamento nos 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 para os ouvintes de rastreamento na coleção Listeners usando o tipo de evento, o identificador de evento, a matriz de argumentos e o formato especificados.

TraceEvent(TraceEventType, Int32)

Origem:
TraceSource.cs
Origem:
TraceSource.cs
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 do evento.

Atributos

Exceções

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

Exemplos

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

ts.TraceEvent(TraceEventType.Warning, 1);
ts.TraceEvent(TraceEventType.Warning, 1)

Comentários

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

O TraceEvent método chama o ShouldTrace método do SourceSwitch objeto retornado pela Switch propriedade . Se ShouldTrace retornar true, TraceEvent chamará o método correspondente TraceEvent de cada ouvinte. Caso contrário, TraceEvent retornará 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 origem do rastreamento, sua identidade numérica e o tipo de evento. O conteúdo de rastreamento adicional depende do valor da propriedade do TraceOutputOptions ouvinte.

Observação

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

Aplica-se a

TraceEvent(TraceEventType, Int32, String)

Origem:
TraceSource.cs
Origem:
TraceSource.cs
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")]
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 do evento.

message
String

A mensagem de rastreamento a ser gravada.

Atributos

Exceções

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

Exemplos

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

// 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 TraceEvent método destina-se a rastrear eventos que podem ser processados automaticamente por ferramentas. Por exemplo, uma ferramenta de monitoramento poderá notificar um administrador se um evento específico for rastreado por uma fonte específica.

O TraceEvent método chama o ShouldTrace método do SourceSwitch objeto retornado pela Switch propriedade . Se ShouldTrace retornar true, TraceEvent chamará o método correspondente TraceEvent de cada ouvinte. Caso contrário, TraceEvent retornará 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 origem do rastreamento, sua identidade numérica, o tipo de evento e a mensagem. O conteúdo de rastreamento adicional depende do valor da propriedade do TraceOutputOptions ouvinte.

Observação

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

Aplica-se a

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

Origem:
TraceSource.cs
Origem:
TraceSource.cs
Origem:
TraceSource.cs

Grava um evento de rastreamento para os ouvintes de rastreamento na coleção Listeners usando o tipo de evento, o identificador de evento, a matriz de argumentos e o formato 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")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params 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 do evento.

format
String

Uma cadeia de caracteres de formato de composição que contém texto intercalado com zero ou mais itens de formato correspondentes a objetos na matriz args.

args
Object[]

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

Atributos

Exceções

format é null.

format é inválido.

- ou -

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

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

Exemplos

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

// 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 format parâmetro , consulte Formatação composta.

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

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

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

Observação

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

Confira também

Aplica-se a