Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

Debug (Clase)

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

System.Object
  System.Diagnostics.Debug

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

public static class Debug

El tipo Debug expone los siguientes miembros.

  NombreDescripción
Propiedad públicaMiembro estáticoCompatible con XNA FrameworkAutoFlushObtiene o establece un valor que indica si debe llamarse al método Flush en la propiedad Listeners después de cada escritura.
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 agentes de escucha que está supervisando los resultados de la depuración.
Arriba

  NombreDescripción
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsAssert(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 FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsAssert(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 FrameworkCompatible con Biblioteca de clases portableAssert(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áticoAssert(Boolean, String, String, Object[])Comprueba una condición; si esta es false, muestra dos mensajes (simple y con formato) 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 llama al método Close en cada uno de los Listeners.
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 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 la colección de Listeners.
Método públicoMiembro estáticoIndentAumenta en uno el valor actual de la propiedad IndentLevel.
Método públicoMiembro estáticoPrint(String)Escribe un mensaje seguido de un terminador de línea en los agentes de escucha de seguimiento de la colección de Listeners.
Método públicoMiembro estáticoPrint(String, Object[])Escribe una cadena con formato seguida de un terminador de línea en los agentes de escucha de seguimiento de la colección de Listeners.
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 de 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 de Listeners.
Método públicoMiembro estáticoCompatible con XNA FrameworkWrite(Object, String)Escribe el nombre de categoría y el valor del método ToString del objeto en los agentes de escucha de seguimiento de la colección de 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 de 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 de 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 de 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 de 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 de Listeners si una condición es true.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(Object)Escribe el valor del método ToString del objeto en los agentes de escucha de seguimiento de la colección de Listeners.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(String)Escribe un mensaje seguido de un terminador de línea en los agentes de escucha de seguimiento de la colección de Listeners.
Método públicoMiembro estáticoCompatible con XNA FrameworkWriteLine(Object, String)Escribe el nombre de categoría y el valor del método ToString del objeto en los agentes de escucha de seguimiento de la colección de Listeners.
Método públicoMiembro estáticoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLine(String, Object[])Escribe un mensaje con formato seguida de un terminador de línea en los agentes de escucha de seguimiento de la colección de 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 de 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 de Listeners si una condición es true.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWriteLineIf(Boolean, String)Escribe un mensaje en los agentes de escucha de seguimiento de la colección de 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 de 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 de Listeners si una condición es true.
Arriba

Si utiliza métodos de la clase Debug para imprimir información de depuración y comprueba la lógica mediante aserciones, puede hacer que el código sea más robusto sin que se vean afectados el rendimiento y el tamaño de código del producto entregado.

Esta clase proporciona métodos para mostrar un cuadro de diálogo Assert y emitir una aserción que siempre produzca un error. Esta clase proporciona métodos escribe 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 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. De forma predeterminada, la clase DefaultTraceListener emite resultados de seguimiento.

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 Debug en bloques try/catch para detectar y administrar cualquier excepción de los agentes de escucha de seguimiento.

Puede modificar el nivel de sangría con el método Indent o la propiedad IndentLevel . Para modificar el espaciado de sangría, utilice la propiedad IndentSize . Puede especificar si automáticamente vaciar el búfer de salida después de cada escritura estableciendo la propiedad AutoFlush en true.

Con el fin de establecer las propiedades AutoFlush e IndentSize para Debug, se puede modificar el archivo de configuración que corresponde al nombre de la aplicación. El archivo de configuración debería tener el formato que se muestra en el siguiente ejemplo.

<configuration>
  <system.diagnostics>
    <trace autoflush="true" indentsize="7" />
  </system.diagnostics>
</configuration>

El atributo ConditionalAttribute se aplica a los métodos de Debug. Los compiladores que admiten ConditionalAttribute omiten las llamadas a estos métodos a menos que se defina "DEBUG" 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.

NotaNota

De forma predeterminada, en los proyectos de Visual Studio C# y Visual Basic 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, vea la documentación de Visual Studio. Para obtener información acerca de la depuración condicional en Visual C++, vea Debug (Clase) (C++/CLI).

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

En el siguiente ejemplo se utiliza Debug para indicar el comienzo y el fin de la ejecución de un programa. El ejemplo también utiliza Indent y Unindent para distinguir traza.


// Specify /d:DEBUG when compiling.

using System;
using System.Data;
using System.Diagnostics;

class Test
{
    static void Main()
    {
       Debug.Listeners.Add(new TextWriterTraceListener(Console.Out));
       Debug.AutoFlush = true;
       Debug.Indent();
       Debug.WriteLine("Entering Main");
       Console.WriteLine("Hello World.");
       Debug.WriteLine("Exiting Main"); 
       Debug.Unindent();
    }
}


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft