TraceSource.TraceEvent Método

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

Atributos

ConditionalAttribute

Exceções

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 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 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 TraceEvent método chama o ShouldTrace método do SourceSwitch objeto retornado pela Switch propriedade. 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.

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

Atributos

ConditionalAttribute

Exceções

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 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 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 TraceEvent método chama o ShouldTrace método do SourceSwitch objeto retornado pela Switch propriedade. 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.

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

Atributos

ConditionalAttribute

Exceções

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

O TraceEvent método 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 TraceEvent método chama o ShouldTrace método do SourceSwitch objeto retornado pela Switch propriedade. 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.

Confira também

• 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