Cómo: Agregar instrucciones de seguimiento al código de una aplicaciónHow to: Add Trace Statements to Application Code

Los métodos que se usan con mayor frecuencia para seguimiento son los métodos para escribir los resultados en agentes de escucha: Write, WriteIf, WriteLine, WriteLineIf, Assert y Fail.The methods used most often for tracing are the methods for writing output to listeners: Write, WriteIf, WriteLine, WriteLineIf, Assert, and Fail. Estos métodos se pueden dividir en dos categorías: Write, WriteLine y Fail emiten resultados de forma incondicional, mientras que WriteIf, WriteLineIf y Assert prueban una condición booleana y escriben o no escriben en función del valor de la condición.These methods can be divided into two categories: Write, WriteLine, and Fail all emit output unconditionally, whereas WriteIf, WriteLineIf, and Assert test a Boolean condition, and write or do not write based on the value of the condition. WriteIf y WriteLineIf emiten resultados si la condición es true y Assert emite resultados si la condición es false.WriteIf and WriteLineIf emit output if the condition is true, and Assert emits output if the condition is false.

Al diseñar la estrategia de depuración y traza, debe pensar cómo desea presentar los resultados.When designing your tracing and debugging strategy, you should think about how you want the output to look. Varias instrucciones Write con información no relacionada crearán un registro difícil de leer.Multiple Write statements filled with unrelated information will create a log that is difficult to read. Por otro lado, usar WriteLine para colocar instrucciones relacionadas en líneas independientes puede hacer que sea difícil distinguir la información del mismo tipo.On the other hand, using WriteLine to put related statements on separate lines may make it difficult to distinguish what information belongs together. En general, use varias instrucciones Write cuando quiera combinar información de varios orígenes para crear un único mensaje informativo y use la instrucción WriteLine cuando quiera crear un único mensaje completo.In general, use multiple Write statements when you want to combine information from multiple sources to create a single informative message, and use the WriteLine statement when you want to create a single, complete message.

Para escribir una línea completaTo write a complete line

  1. Llame al método WriteLine o WriteLineIf.Call the WriteLine or WriteLineIf method.

    Se agrega un retorno de carro al final del mensaje que devuelve este método, para que el siguiente mensaje devuelto por Write, WriteIf, WriteLine o WriteLineIf comience en la línea siguiente:A carriage return is appended to the end of the message this method returns, so that the next message returned by Write, WriteIf, WriteLine, or WriteLineIf will begin on the following line:

    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 parcialTo write a partial line

  1. Llame al método Write o WriteIf.Call the Write or WriteIf method.

    El siguiente mensaje generado por Write, WriteIf, WriteLine o WriteLineIf empezará en la misma línea que el mensaje generado por la instrucción Write o WriteIf:The next message put out by a Write, WriteIf, WriteLine, or WriteLineIf will begin on the same line as the message put out by the Write or WriteIf statement:

    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 que se cumplen ciertas condiciones antes o después de ejecutar un métodoTo verify that certain conditions exist either before or after you execute a method

  1. Llame al método Assert.Call the Assert method.

    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 usar Assert con la depuración y el seguimiento.You can use Assert with both tracing and debugging. En este ejemplo se envía la pila de llamadas a cualquier agente de escucha de la colección Listeners.This example outputs the call stack to any listener in the Listeners collection. Para más información, vea Aserciones en el código administrado y Debug.Assert.For more information, see Assertions in Managed Code and Debug.Assert.

Vea tambiénSee Also

Debug.WriteIf
Debug.WriteLineIf
Trace.WriteIf
Trace.WriteLineIf
Seguimiento e instrumentación de aplicacionesTracing and Instrumenting Applications
Creación, inicialización y configuración de modificadores de seguimientoHow to: Create, Initialize and Configure Trace Switches
Modificadores de seguimientoTrace Switches
Agentes de escucha de seguimientoTrace Listeners