Trace Trace Trace Trace Class

Definición

Proporciona un conjunto de métodos y propiedades que ayudan a realizar un seguimiento del código.Provides a set of methods and properties that help you trace the execution of your code. Esta clase no puede heredarse.This class cannot be inherited.

public ref class Trace sealed
public sealed class Trace
type Trace = class
Public NotInheritable Class Trace
Herencia
TraceTraceTraceTrace

Ejemplos

En el ejemplo siguiente Trace se utiliza para indicar el principio y el final de la ejecución de un programa.The following example uses Trace to indicate the beginning and the end of a program's execution. En el ejemplo también se Trace.Indent usan Trace.Unindent los métodos y para distinguir los resultados de la traza.The example also uses the Trace.Indent and Trace.Unindent methods to distinguish the tracing output. Para obtener un ejemplo más completo del uso de Trace, consulte cómo: Agregue instrucciones de seguimiento al códigode la aplicación.For a more complete example of the use of Trace, see How to: Add Trace Statements to Application Code.

// Specify /DTRACE when compiling.

#using <System.dll>
using namespace System;
using namespace System::Diagnostics;

int main()
{
   #if defined(TRACE)
   Trace::Listeners->Add( gcnew TextWriterTraceListener( Console::Out ) );
   Trace::AutoFlush = true;
   Trace::Indent();
   Trace::WriteLine( "Entering Main" );
   #endif
   Console::WriteLine( "Hello World." );
   #if defined(TRACE)
   Trace::WriteLine( "Exiting Main" );
   Trace::Unindent();
   #endif
   return 0;
}
// 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();
    }
}
' Specify /d:TRACE=True when compiling.

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

End Class

Comentarios

Puede usar las propiedades y los métodos de la Trace clase para instrumentar las compilaciones de versión.You can use the properties and methods in the Trace class to instrument release builds. La instrumentación permite supervisar el estado de la aplicación que se ejecuta en la configuración de la vida real.Instrumentation allows you to monitor the health of your application running in real-life settings. El seguimiento le ayuda a aislar problemas y corregirlos sin alterar un sistema en ejecución.Tracing helps you isolate problems and fix them without disturbing a running system.

Esta clase proporciona métodos para mostrar un Assert cuadro de diálogo y para emitir una aserción que siempre Failserá.This class provides methods to display an Assert dialog box, and to emit an assertion that will always Fail. Esta clase proporciona métodos de escritura en las siguientes variaciones Write: WriteLine, WriteIf, y WriteLineIf.This class provides write methods in the following variations: Write, WriteLine, WriteIf, and WriteLineIf.

Las BooleanSwitch clases TraceSwitch y proporcionan medios para controlar dinámicamente los resultados del seguimiento.The BooleanSwitch and TraceSwitch classes provide means to dynamically control the tracing output. Puede modificar los valores de estos modificadores sin volver a compilar la aplicación.You can modify the values of these switches without recompiling your application. Para obtener información sobre el uso del archivo de configuración para establecer un modificador, vea la Switch clase y el procedimiento: Tema crear, inicializar y configurar modificadores de seguimiento.For information on using the configuration file to set a switch, see the Switch class and the How to: Create, Initialize and Configure Trace Switches topic.

Puede personalizar el destino del resultado de seguimiento agregando TraceListener instancias a la colección o quitando Listeners instancias de la misma.You can customize the tracing output's target by adding TraceListener instances to or removing instances from the Listeners collection. La colección se comparte mediante las Debug Trace clases y. al agregar un agente de escucha de seguimiento a cualquiera de las clases, se agrega el agente de escucha a ambos. ListenersThe Listeners collection is shared by both the Debug and the Trace classes; adding a trace listener to either class adds the listener to both. De forma predeterminada, los resultados de seguimiento se DefaultTraceListener emiten mediante la clase.By default, trace output is emitted using the DefaultTraceListener class.

Nota

Agregar un agente de escucha de seguimiento Listeners a la colección puede hacer que se produzca una excepción durante el seguimiento, si un recurso utilizado por el agente de escucha de seguimiento no está disponible.Adding a trace listener to the Listeners collection can cause an exception to be thrown while tracing, if a resource used by the trace listener is not available. Las condiciones y la excepción que se producen dependen del agente de escucha de seguimiento y no se pueden enumerar en este tema.The conditions and the exception thrown depend on the trace listener and cannot be enumerated in this topic. Puede ser útil realizar llamadas a los métodos de Trace try / catch los bloques para detectar y controlar las excepciones de los agentes de escucha de seguimiento.It may be useful to place calls to the Trace methods in try/catch blocks to detect and handle any exceptions from trace listeners.

Nota

Si agrega agentes de escucha de seguimiento al código de confianza parcial, obtendrá una SecurityException excepción, porque la adición de agentes de UnmanagedCode escucha de seguimiento requiere el permiso.If you add trace listeners to partially trusted code, you will get a SecurityException exception, because adding trace listeners requires UnmanagedCode permission. Para realizar el seguimiento del código de confianza parcial que se ejecuta en un espacio aislado en Visual Studio, no agregue agentes de escucha de seguimiento.To trace partially trusted code that is running in a sandbox in Visual Studio, do not add trace listeners. En su lugar, vea Trace los Debug mensajes y en la ventana de salida .Instead, view the Trace and Debug messages in the Output window.

La Trace clase proporciona propiedades para obtener o establecer el nivel de Indent, IndentSizey si después de AutoFlush cada escritura.The Trace class provides properties to get or set the level of Indent, the IndentSize, and whether to AutoFlush after each write.

Para establecer AutoFlush y IndentSize para Trace, puede editar el archivo de configuración que se corresponde con el nombre de la aplicación.To set the AutoFlush and IndentSize for Trace, you can edit the configuration file that corresponds to the name of your application. El archivo de configuración debe tener el formato del siguiente ejemplo:The configuration file should be formatted like the following example:

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

El ConditionalAttribute atributo se aplica a los métodos de Trace.The ConditionalAttribute attribute is applied to the methods of Trace. Los compiladores que ConditionalAttribute admiten llamadas de omisión a estos métodos a menos que "trace" se defina como un símbolo de compilación condicional.Compilers that support ConditionalAttribute ignore calls to these methods unless "TRACE" is defined as a conditional compilation symbol. Consulte la documentación del compilador para determinar ConditionalAttribute si se admite y la sintaxis para definir un símbolo de compilación condicional.Refer to a compiler's documentation to determine whether ConditionalAttribute is supported and the syntax for defining a conditional compilation symbol.

Nota

En los proyectos de Visual Studio, de forma predeterminada, el símbolo de compilación condicional "DEBUG" se define para las compilaciones de depuración y el símbolo "TRACE" se define para las compilaciones de depuración y de versión.In Visual Studio projects, by default, the "DEBUG" conditional compilation symbol is defined for debug builds, and the "TRACE" symbol is defined for both debug and release builds. Para obtener información sobre cómo deshabilitar este comportamiento, vea la documentación de Visual Studio.For information about how to disable this behavior, see the Visual Studio documentation.

Para definir el símbolo de compilación condicional "trace" C#en, agregue /d:TRACE la opción a la línea de comandos del compilador cuando compile el código mediante una línea #define TRACE de comandos, o bien agregue al principio del archivo.To define the "TRACE" conditional compilation symbol in C#, add the /d:TRACE option to the compiler command line when you compile your code using a command line, or add #define TRACE to the top of your file. En Visual Basic, agregue la /d:TRACE=True opción a la línea de comandos del compilador o agréguela #Const TRACE=True al archivo.In Visual Basic, add the /d:TRACE=True option to the compiler command line or add #Const TRACE=True to the file.

ConditionalAttributeno es compatible con el C++ compilador.ConditionalAttribute is not supported by the C++ compiler. Para proporcionar una funcionalidad equivalente, debe incluir llamadas a los métodos de Trace en un #if defined(TRACE) ... #endif bloque y agregar la /DTRACE opción a la línea de comandos del compilador o agregar #define TRACE al archivo.To provide equivalent functionality, you must enclose calls to the methods of Trace in an #if defined(TRACE) ... #endif block, and add the /DTRACE option to the compiler command line or add #define TRACE to the file.

Propiedades

AutoFlush AutoFlush AutoFlush AutoFlush

Obtiene o establece si debe llamarse a Flush() en Listeners después de cada escritura.Gets or sets whether Flush() should be called on the Listeners after every write.

CorrelationManager CorrelationManager CorrelationManager CorrelationManager

Obtiene el administrador de correlación para el subproceso de este seguimiento.Gets the correlation manager for the thread for this trace.

IndentLevel IndentLevel IndentLevel IndentLevel

Obtiene o establece el nivel de sangría.Gets or sets the indent level.

IndentSize IndentSize IndentSize IndentSize

Obtiene o establece el número de espacios de una sangría.Gets or sets the number of spaces in an indent.

Listeners Listeners Listeners Listeners

Obtiene la colección de los agentes de escucha que está supervisando los resultados del seguimiento.Gets the collection of listeners that is monitoring the trace output.

UseGlobalLock UseGlobalLock UseGlobalLock UseGlobalLock

Obtiene o establece un valor que indica si debe utilizarse el bloqueo global.Gets or sets a value indicating whether the global lock should be used.

Métodos

Assert(Boolean) Assert(Boolean) Assert(Boolean) Assert(Boolean)

Comprueba una condición; si la condición es false, aparece un cuadro de mensaje que muestra la pila de llamadas.Checks for a condition; if the condition is false, displays a message box that shows the call stack.

Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String) Assert(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.Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

Assert(Boolean, String, String) Assert(Boolean, String, String) Assert(Boolean, String, String) Assert(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.Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

Close() Close() Close() Close()

Vacía el búfer de resultados y, a continuación, cierra Listeners.Flushes the output buffer, and then closes the Listeners.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Fail(String) Fail(String) Fail(String) Fail(String)

Emite el mensaje de error especificado.Emits the specified error message.

Fail(String, String) Fail(String, String) Fail(String, String) Fail(String, String)

Emite un mensaje de error y un mensaje de error detallado.Emits an error message, and a detailed error message.

Flush() Flush() Flush() Flush()

Vacía el búfer de resultados y hace que los datos almacenados en el búfer se escriban en Listeners.Flushes the output buffer, and causes buffered data to be written to the Listeners.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
Indent() Indent() Indent() Indent()

Aumenta en uno el valor actual de la propiedad IndentLevel.Increases the current IndentLevel by one.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
Refresh() Refresh() Refresh() Refresh()

Actualiza los datos de configuración del seguimiento.Refreshes the trace configuration data.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
TraceError(String) TraceError(String) TraceError(String) TraceError(String)

Escribe un mensaje de error en los agentes de escucha de seguimiento de la colección Listeners mediante el mensaje especificado.Writes an error message to the trace listeners in the Listeners collection using the specified message.

TraceError(String, Object[]) TraceError(String, Object[]) TraceError(String, Object[]) TraceError(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.Writes an error message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

TraceInformation(String) TraceInformation(String) TraceInformation(String) TraceInformation(String)

Escribe un mensaje informativo en los agentes de escucha de seguimiento de la colección Listeners mediante el mensaje especificado.Writes an informational message to the trace listeners in the Listeners collection using the specified message.

TraceInformation(String, Object[]) TraceInformation(String, Object[]) TraceInformation(String, Object[]) TraceInformation(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.Writes an informational message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

TraceWarning(String) TraceWarning(String) TraceWarning(String) TraceWarning(String)

Escribe un mensaje de advertencia en los agentes de escucha de seguimiento de la colección Listeners utilizando el mensaje especificado.Writes a warning message to the trace listeners in the Listeners collection using the specified message.

TraceWarning(String, Object[]) TraceWarning(String, Object[]) TraceWarning(String, Object[]) TraceWarning(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.Writes a warning message to the trace listeners in the Listeners collection using the specified array of objects and formatting information.

Unindent() Unindent() Unindent() Unindent()

Disminuye en uno el valor actual de la propiedad IndentLevel.Decreases the current IndentLevel by one.

Write(Object) Write(Object) Write(Object) Write(Object)

Escribe el valor del método ToString() del objeto en los agentes de escucha de seguimiento de la colección Listeners.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

Write(Object, String) Write(Object, String) Write(Object, String) Write(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.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

Write(String) Write(String) Write(String) Write(String)

Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners.Writes a message to the trace listeners in the Listeners collection.

Write(String, String) Write(String, String) Write(String, String) Write(String, String)

Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento de la colección Listeners.Writes a category name and a message to the trace listeners in the Listeners collection.

WriteIf(Boolean, Object) WriteIf(Boolean, Object) WriteIf(Boolean, Object) WriteIf(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.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, Object, String) WriteIf(Boolean, Object, String) WriteIf(Boolean, Object, String) WriteIf(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.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, String) WriteIf(Boolean, String) WriteIf(Boolean, String) WriteIf(Boolean, String)

Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.Writes a message to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, String, String) WriteIf(Boolean, String, String) WriteIf(Boolean, String, String) WriteIf(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.Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

WriteLine(Object) WriteLine(Object) WriteLine(Object) WriteLine(Object)

Escribe el valor del método ToString() del objeto en los agentes de escucha de seguimiento de la colección Listeners.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(Object, String) WriteLine(Object, String) WriteLine(Object, String) WriteLine(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.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners.Writes a message to the trace listeners in the Listeners collection.

WriteLine(String, String) WriteLine(String, String) WriteLine(String, String) WriteLine(String, String)

Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento de la colección Listeners.Writes a category name and message to the trace listeners in the Listeners collection.

WriteLineIf(Boolean, Object) WriteLineIf(Boolean, Object) WriteLineIf(Boolean, Object) WriteLineIf(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.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, Object, String) WriteLineIf(Boolean, Object, String) WriteLineIf(Boolean, Object, String) WriteLineIf(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.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, String) WriteLineIf(Boolean, String) WriteLineIf(Boolean, String) WriteLineIf(Boolean, String)

Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.Writes a message to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, String, String) WriteLineIf(Boolean, String, String) WriteLineIf(Boolean, String, String) WriteLineIf(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.Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

Seguridad

SecurityPermission
para trabajar con código no administrado.for operating with unmanaged code. Acción de seguridad Demand:.Security action: Demand. Enumeración asociada:UnmanagedCodeAssociated enumeration: UnmanagedCode

Se aplica a

Seguridad para subprocesos

Este tipo es seguro para la ejecución de subprocesos.This type is thread safe.

Consulte también: