Cómo: Agregar instrucciones de seguimiento al código de una aplicación

Los métodos utilizados con más frecuencia para la traza son los que escriben información en los agentes de escucha: Write, WriteIf, WriteLine, WriteLineIf, Assert y Fail. Estos métodos se pueden dividir en dos categorías: Write, WriteLine y Fail envían resultados de manera incondicional, mientras que WriteIf, WriteLineIf y Assert comprueban una condición de tipo Boolean y escriben o no según el valor de la condición. WriteIf y WriteLineIf envían resultados si la condición toma el valor true; Assert envía el resultado si la condición toma el valor false.

Cuando diseñe la estrategia de traza y depuración, debería pensar en la forma de presentar los resultados. Varias instrucciones Write con información no relacionada producirán un registro difícil de leer. Por otro lado, si utiliza WriteLine para colocar instrucciones relacionadas en líneas independientes, puede resultar difícil distinguir cuál es la información correspondiente. En general, utilice varias instrucciones Write cuando desee combinar información de varios orígenes en un único mensaje informativo, y la instrucción Write cuando desee crear un único mensaje completo.

Para escribir una línea completa

• Llame al método WriteLine o WriteLineIf.

  El mensaje que devuelve este método contiene un retorno de carro al final, de modo que el siguiente mensaje devuelto por Write, WriteIf, WriteLine o WriteLineIf empezará en la línea siguiente:

  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.");
  

Para escribir una línea parcial

• Llame al método Write o WriteIf.

  El siguiente mensaje generado por un método Write, WriteIf, WriteLine o WriteLineIf empezará en la misma línea que el mensaje generado por la instrucción Write o WriteIf:

  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");
  

Para comprobar si determinadas condiciones se cumplen antes o después de ejecutar un método

• Llame al 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.");
  

  Nota
  Puede utilizar Assert tanto con la traza como con la depuración.Este ejemplo envía el contenido de la pila de llamadas a cualquier agente de escucha de la colección Listeners.Para obtener más información, vea Aserciones en el código administrado y Debug.Assert.

Vea también

Tareas

Cómo: Configurar modificadores de seguimiento

Referencia

Debug.WriteIf

Debug.WriteLineIf

Trace.WriteIf

Trace.WriteLineIf

Conceptos

Introducción a la instrumentación y el seguimiento

Modificadores de seguimiento

Agentes de escucha de seguimiento

Otros recursos

Seguimiento e instrumentación de aplicaciones