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

Artículo
08/23/2008

Actualización: noviembre 2007

Los métodos utilizados con más frecuencia para el seguimiento 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 seguimiento 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.");

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

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

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

Nota:
Puede utilizar Assert tanto con el seguimiento 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

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

Para escribir una línea completa

Para escribir una línea parcial

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

Vea también

Tareas

Conceptos

Referencia

Otros recursos

Recursos adicionales