TraceSource.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 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 -> unitPublic 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 -> unitPublic 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[] -> unitPublic 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
- Formatação de composição
- 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
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de