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

Artigo
08/01/2011

Os métodos usados com mais freqüência para rastreamento são os métodos para gravar a saída para os ouvintes: Gravar, WriteIf, WriteLine, WriteLineIf, Assert, e Falha. Esses métodos podem ser divididos em duas categorias: Gravar, WriteLine, e Falha todos emitem saída incondicionalmente, enquanto WriteIf, WriteLineIf, e Assert testar um Boolean condição e escrever ou não gravar com base no valor da condição. WriteIf e WriteLineIf emitir saída da condição é true, e Assert emite saída se a condição for false.

Ao projetar seu rastreamento e depuração de estratégia, você deve pensar sobre 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 outro lado, usando WriteLine para colocar instruções relacionadas em linhas separadas podem dificultar a distinguir quais informações deveriam estar juntos. Em geral, usar várias gravar instruções quando você deseja combinar informações de várias fontes para criar uma única mensagem informativa e o WriteLine instrução quando você deseja criar uma mensagem simples e completa.

Escrever uma linha completa

Chamar o WriteLine ou WriteLineIf método.

Um retorno de carro é acrescentado ao final da mensagem, esse método retorna, para que a próxima mensagem retornada por gravar, WriteIf, WriteLine, ou 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

Chamar o Write ou WriteIf método.

A próxima mensagem esteve um gravar, WriteIf, WriteLine, ou WriteLineIf iniciará na mesma linha que a mensagem que esteve gravar ou WriteIf instrução:

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 que certos condições antes ou depois de você executa 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 Assert com o rastreamento e depuração.Este exemplo produz qualquer ouvinte na pilha de chamadas de ouvintes coleção.Para obter mais informações, consulte itens no código gerenciado e Debug.Assert.

Consulte também

Compartilhar via

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

Escrever uma linha completa

Escrever uma linha parcial

Para verificar que certos condições antes ou depois de você executa um método

Consulte também

Tarefas

Referência

Conceitos

Outros recursos

Recursos adicionais