Como: Adicionar instruções de rastreamento ao código do aplicativo

Os métodos usados com mais freqüência para rastreamento são os métodos para gravar saída ouvintes: gravar, WriteIf, WriteLine, WriteLineIf, Declarar, and Falha.Esses métodos podem ser divididos em duas categorias: gravar, WriteLine, and Falha todos emitem saída incondicionalmente, enquanto WriteIf, WriteLineIf, and Declarar teste a booliano condição e escrever ou não escreva com base no valor de condição.WriteIf and WriteLineIf emitir saída da condição é True, and Declarar emite saída se a condição for False.

Ao projetar seu rastreamento e depuração de estratégia, você deve pensar como você deseja que a saída para pesquisar.Vários gravar instruções preenchidas com informações não relacionadas criará um log que é difícil de ler.Por Outros lado, usando WriteLine colocar instruções relacionadas em linhas separadas podem tornar difícil distinguir quais informações em conjunto pertence.Em geral, use vários gravar instruções quando você deseja agrupar informações de várias origens para criar uma única mensagem informativa e o WriteLine demonstrativo quando desejar criar uma mensagem simples e completa.

Para gravar uma linha completa

• telefonar the WriteLine ou WriteLineIf método.

  Um retorno de carro é acrescentado ao participante da mensagem, que esse método retorna, para que a próxima mensagem retornada por gravar, WriteIf, WriteLine, or WriteLineIf começará na linha a seguir:

  Dim errorFlag As Boolean = False
  Trace.WriteLine("Error in AppendData procedure.")
  Trace.WriteLineIf(errorFlag, "Error in AppendData procedure.") 
  

  bool errorFlag = false;
  System.Diagnostics.Trace.WriteLine ("Error in AppendData procedure.");
  System.Diagnostics.Trace.WriteLineIf(errorFlag, 
     "Error in AppendData procedure.");
  

  boolean errorFlag = false;
  System.Diagnostics.Trace.WriteLine("Error in AppendData procedure.");
  System.Diagnostics.Trace.WriteLineIf(errorFlag, 
     "Error in AppendData procedure.");
  

Escrever uma linha parcial

• telefonar the Write ou WriteIf método.

  A próxima mensagem coloque check-out por um gravar, WriteIf, WriteLine, or WriteLineIf iniciará na mesma linha que a mensagem colocada, a gravar or WriteIf demonstrativo:

  Dim errorFlag As Boolean = False
  Trace.WriteIf(errorFlag, "Error in AppendData procedure.")
  Debug.WriteIf(errorFlag, "Transaction abandoned.")
  Trace.Write("Invalid value for data request")
  

  bool errorFlag = false;
  System.Diagnostics.Trace.WriteIf(errorFlag, 
     "Error in AppendData procedure.");
  System.Diagnostics.Debug.WriteIf(errorFlag, "Transaction abandoned.");
  Trace.Write("Invalid value for data request");
  

  boolean errorFlag = false;
  System.Diagnostics.Trace.WriteIf(errorFlag, "Error in AppendData procedure.");
  System.Diagnostics.Debug.WriteIf(errorFlag, "Transaction abandoned.");
        System.Diagnostics.Trace.Write("Invalid value for data request");
  

Para verificar se existem condições que certos antes ou depois de executar um método

• Chame o método Assert.

  Dim I As Integer = 4
  Trace.Assert(I = 5, "I is not equal to 5.")
  

  int I = 4;
  System.Diagnostics.Trace.Assert(I == 5, "I is not equal to 5.");
  

  int I = 4;
  System.Diagnostics.Trace.Assert(I == 5, "I is not equal to 5.");
  

  Observação:
  Você pode usar Declarar com o rastreamento e depuração.Este exemplo produz a pilha de chamadas para qualquer ouvinte no Ouvintes coleção.Para obter mais informações, consulte Asserção em código gerenciado and Debug.Assert.

Consulte também

Tarefas

Como: Configurar opções de rastreamento

Conceitos

Introdução à instrumentação e rastreamento

Opções de rastreamento

Ouvintes de rastreamento

Referência

Debug.WriteIf

Debug.WriteLineIf

Trace.WriteIf

Trace.WriteLineIf

Outros recursos

Rastreamento e intrumentando aplicações