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 seguinte exemplo de código mostra a utilização do TraceEvent(TraceEventType, Int32) método para passar um evento trace aos 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)

Observações

O TraceEvent método destina-se a rastrear eventos que podem ser processados automaticamente por ferramentas. Por exemplo, uma ferramenta de monitorização 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 devolvido pela Switch propriedade. Se ShouldTrace retorna true, TraceEvent chama o método correspondente TraceEvent de cada ouvinte. Caso contrário, TraceEvent retorna sem chamar os métodos dos ouvintes.

O conteúdo do rastreio é específico do ouvinte. Se o método não for sobreposto pela implementação do ouvinte, a saída padrão é o nome da fonte do traço, a sua identidade numérica e o tipo de evento. Conteúdo adicional de traços depende do valor da propriedade do TraceOutputOptions 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 seguinte exemplo de código mostra a utilização do TraceEvent(TraceEventType, Int32) método para passar um evento trace aos 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")

Observações

O TraceEvent método destina-se a rastrear eventos que podem ser processados automaticamente por ferramentas. Por exemplo, uma ferramenta de monitorização 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 devolvido pela Switch propriedade. Se ShouldTrace retorna true, TraceEvent chama o método correspondente TraceEvent de cada ouvinte. Caso contrário, TraceEvent retorna sem chamar os métodos dos ouvintes.

O conteúdo do rastreio é específico do ouvinte. Se o método não for sobreposto pela implementação do ouvinte, a saída padrão é o nome da fonte do traço, a sua identidade numérica, o tipo de evento e a mensagem. Conteúdo adicional de traços depende do valor da propriedade do TraceOutputOptions 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 seguinte exemplo de código mostra a utilização do TraceEvent(TraceEventType, Int32) método para passar um evento trace aos 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")

Observações

Para 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 monitorização 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 devolvido pela Switch propriedade. Se ShouldTrace retorna true, TraceEvent chama o método correspondente TraceEvent de cada ouvinte. Caso contrário, TraceEvent retorna sem chamar os métodos dos ouvintes.

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

Ver também

• Formatação composta
• Standard Numeric Format Strings (Cadeias de Formato Numérico Padrão)
• Cadeias de caracteres de formato numérico personalizado
• Strings padrão de formato DateTime
• Cadeias de Formato DateTime Personalizadas
• Cadeias de caracteres de formato de enumeração
• Tipos de Formatação em .NET