Exportar (0) Imprimir
Expandir todo
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

Trace (Clase)

Proporciona un conjunto de métodos y propiedades que ayudan a realizar un seguimiento del código. Esta clase no puede heredarse.

System.Object
  System.Diagnostics.Trace

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

public sealed class Trace

El tipo Trace expone los siguientes miembros.

  NombreDescripción
Propiedad públicaMiembro estáticoCompatible con XNA FrameworkAutoFlushObtiene o establece si debe llamarse a Flush en Listeners después de cada escritura.
Propiedad públicaMiembro estáticoCorrelationManagerObtiene el administrador de correlación correspondiente al subproceso de este seguimiento.
Propiedad públicaMiembro estáticoCompatible con XNA FrameworkIndentLevelObtiene o establece el nivel de sangría.
Propiedad públicaMiembro estáticoCompatible con XNA FrameworkIndentSizeObtiene o establece el número de espacios de una sangría.
Propiedad públicaMiembro estáticoCompatible con XNA FrameworkListenersObtiene la colección de los agentes de escucha que está supervisando los resultados del seguimiento.
Propiedad públicaMiembro estáticoUseGlobalLockObtiene o establece un valor que indica si debe utilizarse el bloqueo global.
Arriba

  NombreDescripción
Método públicoMiembro estáticoCompatible con XNA FrameworkAssert(Boolean)Comprueba una condición; si esta es false, muestra un cuadro de mensaje con la pila de llamadas.
Método públicoMiembro estáticoCompatible con XNA FrameworkAssert(Boolean, String)Comprueba una condición; si esta es false, muestra un mensaje especificado y presenta un cuadro de mensaje con la pila de llamadas.
Método públicoMiembro estáticoCompatible con XNA FrameworkAssert(Boolean, String, String)Comprueba una condición; si esta es false, muestra dos mensajes especificados y presenta un cuadro de mensaje con la pila de llamadas.
Método públicoMiembro estáticoCompatible con XNA FrameworkCloseVacía el búfer de resultados y, a continuación, cierra Listeners.
Método públicoCompatible con XNA FrameworkEquals(Object)Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método públicoMiembro estáticoCompatible con XNA FrameworkFail(String)Emite el mensaje de error especificado.
Método públicoMiembro estáticoCompatible con XNA FrameworkFail(String, String)Emite un mensaje de error y un mensaje de error detallado.
Método protegidoCompatible con XNA FrameworkFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoMiembro estáticoCompatible con XNA FrameworkFlushVacía el búfer de resultados y hace que los datos almacenados en el búfer se escriban en Listeners.
Método públicoCompatible con XNA FrameworkGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkGetType Obtiene el Typede la instancia actual. (Se hereda de Object).
Método públicoMiembro estáticoIndentAumenta en uno el valor actual de la propiedad IndentLevel.
Método protegidoCompatible con XNA FrameworkMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoMiembro estáticoRefreshActualiza los datos de configuración del seguimiento.
Método públicoCompatible con XNA FrameworkToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoMiembro estáticoTraceError(String)Escribe un mensaje de error en los agentes de escucha de seguimiento de la colección Listeners mediante el mensaje especificado.
Método públicoMiembro estáticoTraceError(String, Object[])Escribe un mensaje de error en los agentes de escucha de seguimiento de la colección Listeners utilizando la matriz de objetos especificada y la información de formato.
Método públicoMiembro estáticoTraceInformation(String)Escribe un mensaje informativo en los agentes de escucha de seguimiento de la colección Listeners mediante el mensaje especificado.
Método públicoMiembro estáticoTraceInformation(String, Object[])Escribe un mensaje informativo en los agentes de escucha de seguimiento de la colección Listeners utilizando la matriz de objetos especificada y la información de formato.
Método públicoMiembro estáticoTraceWarning(String)Escribe un mensaje de advertencia en los agentes de escucha de seguimiento de la colección Listeners utilizando el mensaje especificado.
Método públicoMiembro estáticoTraceWarning(String, Object[])Escribe un mensaje de advertencia en los agentes de escucha de seguimiento de la colección Listeners utilizando la matriz de objetos especificada y la información de formato.
Método públicoMiembro estáticoUnindentDisminuye en uno el valor actual de la propiedad IndentLevel.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(Object)Escribe el valor del método ToString del objeto en los agentes de escucha de seguimiento de la colección Listeners.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(String)Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(Object, String)Escribe un nombre de categoría y el valor del método ToString del objeto en los agentes de escucha de seguimiento de la colección Listeners.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(String, String)Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento de la colección Listeners.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteIf(Boolean, Object)Escribe el valor del método ToString del objeto en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteIf(Boolean, String)Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteIf(Boolean, Object, String)Escribe un nombre de categoría y el valor del método ToString del objeto en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteIf(Boolean, String, String)Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine(Object)Escribe el valor del método ToString del objeto en los agentes de escucha de seguimiento de la colección Listeners.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine(String)Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine(Object, String)Escribe un nombre de categoría y el valor del método ToString del objeto en los agentes de escucha de seguimiento de la colección Listeners.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine(String, String)Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento de la colección Listeners.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLineIf(Boolean, Object)Escribe el valor del método ToString del objeto en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLineIf(Boolean, String)Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLineIf(Boolean, Object, String)Escribe un nombre de categoría y el valor del método ToString del objeto en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLineIf(Boolean, String, String)Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.
Arriba

Puede utilizar las propiedades y los métodos de la clase Trace para instrumentar las versiones de lanzamiento. La instrumentación le permite supervisar el estado de la aplicación que se está ejecutando en una configuración real. La traza 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 de la traza. 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 la traza, agregue o quite instancias de TraceListener de la colección Listeners. La colección Listeners es compartida por las clases Debug y Trace; si agrega un agente de escucha de traza a cualquiera de las clases, éste se agrega a ambas. Los resultados del seguimiento se emiten de forma predeterminada mediante la clase DefaultTraceListener.

NotaNota

Al agregar un agente de escucha de seguimiento a la colección Listeners se puede originar una excepción que se producirá mientras tiene lugar la traza, si el recurso utilizado por el agente de escucha de traza no está disponible. Las condiciones y la excepción producidas dependen del agente de escucha de seguimiento y no se pueden enumerar en este tema. Puede ser útil para llamar a los métodos Trace en bloques try/catch para detectar y administrar cualquier excepción de los agentes de escucha de seguimiento.

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 acerca de cómo deshabilitar este comportamiento, consulte la documentación de Visual Studio 2005.

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 Trace.Indent y Trace.Unindent para distinguir los resultados de la traza. Para obtener un ejemplo más completo del uso de Trace, vea Cómo: Agregar instrucciones de seguimiento al código de una aplicación.


// Specify /d:TRACE when compiling.

using System;
using System.Diagnostics;

class Test
{
    static void 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();
    }
}


.NET Framework

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

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

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

date

Historial

Motivo

Junio de 2010

Se agrega un vínculo a un ejemplo completo de la sección Ejemplos.

Comentarios de los clientes.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft