Exportar (0) Imprimir
Expandir todo

Trace (Clase)

Actualización: noviembre 2007

Proporciona un conjunto de métodos y propiedades que le ayudan a realizar el seguimiento de la ejecución del código. No se puede heredar esta clase.

Espacio de nombres:  System.Diagnostics
Ensamblado:  System (en System.dll)

'Declaración
Public NotInheritable Class Trace
'Uso
Dim instance As Trace
public final class Trace
public final class Trace

Se pueden utilizar las propiedades y los métodos de la clase Trace para instrumentar versiones de lanzamiento. La instrumentación le permite supervisar el estado de la aplicación que se está ejecutando en una configuración real. El seguimiento ayuda a aislar problemas y a solucionarlos sin interferir en un sistema en ejecución.

Esta clase proporciona métodos para mostrar un cuadro de diálogo Assert y para emitir una aserción que siempre produzca un error (Fail). Esta clase proporciona métodos de escritura en las variaciones siguientes: Write, WriteLine, WriteIf y WriteLineIf.

Las clases BooleanSwitch y TraceSwitch proporcionan medios para controlar de forma dinámica los resultados del seguimiento. Se pueden cambiar los valores de estos modificadores sin volver a compilar la aplicación. Para obtener información sobre cómo utilizar el archivo de configuración para establecer un modificador, vea la clase Switch y el tema Cómo: Configurar modificadores de seguimiento.

Para personalizar el destino de los resultados de seguimiento, agregue o quite instancias de TraceListener de la colección Listeners. Los resultados del seguimiento se emiten de forma predeterminada mediante la clase DefaultTraceListener.

La clase Trace proporciona propiedades para obtener o establecer el nivel de Indent e IndentSize, y si se debe utilizar AutoFlush después de cada escritura.

Con el fin de establecer AutoFlush e IndentSize para Trace, se puede editar el archivo de configuración que corresponde al nombre de la aplicación. El archivo de configuración debe tener el mismo formato que en el siguiente ejemplo:

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="3" />
  </system.diagnostics>
</configuration>

El atributo ConditionalAttribute se aplica a los métodos de Trace. Los compiladores que admiten ConditionalAttribute omiten las llamadas a estos métodos a menos que se defina "TRACE" como símbolo de compilación condicional. Consulte la documentación de un compilador para determinar si se admite ConditionalAttribute y la sintaxis para definir un símbolo de compilación condicional.

Para definir el símbolo de compilación condicional "TRACE" en C# y J#, agregue la opción /d:TRACE a la línea de comandos del compilador cuando compile su código, o bien agregue #define TRACE a la parte superior del archivo. En Visual Basic, agregue la opción /d:TRACE=True a la línea de comandos del compilador o agregue #Const TRACE=True al archivo.

El compilador de C++ no admite ConditionalAttribute. Para proporcionar una funcionalidad equivalente, debe incluir las llamadas a los métodos de Trace en un bloque #if defined(TRACE) ... #endif y agregar la opción /DTRACE a la línea de comandos del compilador o agregar #define TRACE al archivo.

De forma predeterminada, en los proyectos de Visual Studio 2005 se define el símbolo de compilación condicional "DEBUG" para las versiones de depuración y el símbolo "TRACE" para las versiones de depuración y de lanzamiento. Para obtener información sobre cómo deshabilitar este comportamiento, consulte la documentación de Visual Studio 2005.

Nota de la plataforma Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows CE:

.NET Compact Framework no admite las características de seguimiento que utilizan un archivo de configuración.

En el siguiente ejemplo se utiliza Trace para indicar el comienzo y el fin de la ejecución de un programa. También se utilizan los métodos Indent y Unindent para distinguir los resultados de seguimiento.

' Specify /d:TRACE=True when compiling.

Imports System
Imports System.Diagnostics

Class Test

    Shared Sub Main()

        Trace.Listeners.Add(New TextWriterTraceListener(Console.Out))
        Trace.AutoFlush = True
        Trace.Indent()
        Trace.WriteLine("Entering Main")
        Console.WriteLine("Hello World.")
        Trace.WriteLine("Exiting Main")
        Trace.Unindent()

    End Sub 'Main

End Class


System.Object
  System.Diagnostics.Trace

Este tipo es seguro para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC, Xbox 360

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0

XNA Framework

Compatible con: 2.0, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft