Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase Trace

 

Publicado: octubre de 2016

Proporciona un conjunto de métodos y propiedades que le ayudarán a realizar el seguimiento del código. Esta clase no puede heredarse.

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

System.Object
  System.Diagnostics.Trace

[<Sealed>]
type Trace = class end

NombreDescripción
System_CAPS_pubpropertySystem_CAPS_staticAutoFlush

Obtiene o establece si se debe llamar a Flush en debe llamar en los Listeners después de cada escritura.

System_CAPS_pubpropertySystem_CAPS_staticCorrelationManager

Obtiene el administrador de correlación para el subproceso de este seguimiento.

System_CAPS_pubpropertySystem_CAPS_staticIndentLevel

Obtiene o establece el nivel de sangría.

System_CAPS_pubpropertySystem_CAPS_staticIndentSize

Obtiene o establece el número de espacios de una sangría.

System_CAPS_pubpropertySystem_CAPS_staticListeners

Obtiene la colección de agentes de escucha que está supervisando los resultados de seguimiento.

System_CAPS_pubpropertySystem_CAPS_staticUseGlobalLock

Obtiene o establece un valor que indica si se debe utilizar el bloqueo global.

NombreDescripción
System_CAPS_pubmethodSystem_CAPS_staticAssert(Boolean)

Comprueba una condición; si la condición es false, aparece un cuadro de mensaje que muestra la pila de llamadas.

System_CAPS_pubmethodSystem_CAPS_staticAssert(Boolean, String)

Comprueba una condición; si la condición es false, genera un mensaje especificado y muestra un cuadro de mensaje que muestra la pila de llamadas.

System_CAPS_pubmethodSystem_CAPS_staticAssert(Boolean, String, String)

Comprueba una condición; si la condición es false, genera dos mensajes especificados y muestra un cuadro de mensaje que muestra la pila de llamadas.

System_CAPS_pubmethodSystem_CAPS_staticClose()

Vacía el búfer de salida y, a continuación, cierra los Listeners.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_pubmethodSystem_CAPS_staticFail(String)

Emite el mensaje de error especificado.

System_CAPS_pubmethodSystem_CAPS_staticFail(String, String)

Emite un mensaje de error y un mensaje de error detallado.

System_CAPS_pubmethodSystem_CAPS_staticFlush()

Vacía el búfer de salida y hace que los datos almacenados en búfer se escriban en el Listeners.

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodSystem_CAPS_staticIndent()

Aumenta el IndentLevel actual en uno.

System_CAPS_pubmethodSystem_CAPS_staticRefresh()

Actualiza los datos de configuración de seguimiento.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_pubmethodSystem_CAPS_staticTraceError(String)

Escribe un mensaje de error en los agentes de escucha de seguimiento de la colección Listeners con el mensaje especificado.

System_CAPS_pubmethodSystem_CAPS_staticTraceError(String, Object[])

Escribe un mensaje de error en los agentes de escucha de seguimiento de la colección Listeners con la matriz de objetos y la información de formato especificadas.

System_CAPS_pubmethodSystem_CAPS_staticTraceInformation(String)

Escribe un mensaje informativo en los agentes de escucha de seguimiento de la colección Listeners con el mensaje especificado.

System_CAPS_pubmethodSystem_CAPS_staticTraceInformation(String, Object[])

Escribe un mensaje informativo en los agentes de escucha de seguimiento de la colección Listeners con la matriz de objetos y la información de formato especificadas.

System_CAPS_pubmethodSystem_CAPS_staticTraceWarning(String)

Escribe un mensaje de advertencia en los agentes de escucha de seguimiento de la colección Listeners con el mensaje especificado.

System_CAPS_pubmethodSystem_CAPS_staticTraceWarning(String, Object[])

Escribe un mensaje de advertencia en los agentes de escucha de seguimiento de la colección Listeners con la matriz de objetos y la información de formato especificadas.

System_CAPS_pubmethodSystem_CAPS_staticUnindent()

Disminuye el IndentLevel actual en uno.

System_CAPS_pubmethodSystem_CAPS_staticWrite(Object)

Escribe el valor del método ToString del objeto en los agentes de escucha en la colección Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWrite(Object, String)

Escribe un nombre de categoría y el valor del método ToString del objeto en los agentes de escucha en la colección Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWrite(String)

Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWrite(String, String)

Escribe un nombre de categoría y un mensaje a los agentes de escucha de la colección Listeners.

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

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, Object, String)

Escribe un nombre de categoría y el valor del método ToString del objeto en los agentes de escucha en la colección Listeners si una condición es true.

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, String)

Escribe un mensaje a los agentes de escucha de la colección Listeners si una condición es true.

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, String, String)

Escribe un nombre de categoría y un mensaje a los agentes de escucha de la colección Listeners si una condición es true.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(Object)

Escribe el valor del método ToString del objeto en los agentes de escucha en la colección Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(Object, String)

Escribe un nombre de categoría y el valor del método ToString del objeto en los agentes de escucha en la colección Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(String)

Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(String, String)

Escribe un nombre de categoría y un mensaje a los agentes de escucha de la colección Listeners.

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

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, Object, String)

Escribe un nombre de categoría y el valor del método ToString del objeto en los agentes de escucha en la colección Listeners si una condición es true.

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, String)

Escribe un mensaje a los agentes de escucha de la colección Listeners si una condición es true.

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, String, String)

Escribe un nombre de categoría y un mensaje a los agentes de escucha de la colección Listeners si una condición es true.

Puede utilizar las propiedades y métodos en la Trace clase versión instrumento compilaciones. Instrumentación permite supervisar el estado de la aplicación ejecutándose en situaciones reales. El seguimiento ayuda a aislar los problemas y corregirlos sin interrumpir un sistema en ejecución.

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

El BooleanSwitch y TraceSwitch clases proporcionan medios para controlar de forma dinámica los resultados del seguimiento. Puede modificar los valores de estos modificadores sin volver a compilar la aplicación. Para obtener información acerca de cómo utilizar el archivo de configuración para establecer un modificador, vea la Switch clase y el How to: Create, Initialize and Configure Trace Switches tema.

Puede personalizar el destino de los resultados de la traza agregando TraceListener instancias o quite instancias de la Listeners colección. El Listeners colección comparten ambos el Debug y el Trace clases; agregar un agente de escucha de seguimiento a cualquier clase agrega el agente de escucha para ambos. De forma predeterminada, los resultados de seguimiento se emiten mediante el DefaultTraceListener clase.

System_CAPS_noteNota

Agregar un agente de escucha de seguimiento para el Listeners colección puede producir una excepción que se produzca durante el seguimiento, si un recurso utilizado por el agente de escucha de seguimiento no está disponible. Las condiciones y la excepción dependen de la escucha de seguimiento y no se pueden enumerar en este tema. Puede ser útil realizar llamadas a la Trace métodos en try/catch bloques para detectar y controlar las excepciones de los agentes de escucha de seguimiento.

System_CAPS_noteNota

Si agrega los agentes de escucha de seguimiento al código de confianza parcial, obtendrá un SecurityException de excepciones, porque agregar agentes de escucha de seguimiento requiere UnmanagedCode permiso. Para realizar el seguimiento de código de confianza parcial que se ejecuta en un espacio aislado en Visual Studio, no agregue los agentes de escucha de seguimiento. En su lugar, ver el Trace y Debug mensajes en el salida ventana.

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

Para establecer el AutoFlush y IndentSize para Trace, puede editar el archivo de configuración que corresponde al nombre de la aplicación. El archivo de configuración debería tener el formato similar al ejemplo siguiente:

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

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

System_CAPS_noteNota

En proyectos de Visual Studio, de forma predeterminada, se define el símbolo de compilación condicional "DEBUG" para las compilaciones de depuración y se define 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.

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

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

En el ejemplo siguiente se utiliza Trace para indicar el principio y el final de la ejecución de un programa. El ejemplo también utiliza el Trace.Indent y Trace.Unindent métodos para distinguir los resultados del seguimiento. Para obtener un ejemplo más completo del uso de Trace, consulte How to: Add Trace Statements to Application Code.

No hay ningún ejemplo de código disponible o este idioma no es compatible.

SecurityPermission

for operating with unmanaged code. Security action: F:System.Security.Permissions.SecurityAction.Demand. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode

.NET Framework
Disponible desde 1.1

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

Volver al principio
Mostrar: