ConsoleTraceListener Clase
TOC
Collapse the table of content
Expand the table of content
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

ConsoleTraceListener (Clase)

 

Dirige el seguimiento o de depuración a la salida estándar o la secuencia de error estándar.

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

System.Object
  System.MarshalByRefObject
    System.Diagnostics.TraceListener
      System.Diagnostics.TextWriterTraceListener
        System.Diagnostics.ConsoleTraceListener

[<HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)>]
type ConsoleTraceListener = 
    class
        inherit TextWriterTraceListener
    end

NombreDescripción
System_CAPS_pubmethodConsoleTraceListener()

Inicializa una nueva instancia de la ConsoleTraceListener clase con los resultados de seguimiento escritos en la secuencia de salida estándar.

System_CAPS_pubmethodConsoleTraceListener(Boolean)

Inicializa una nueva instancia de la ConsoleTraceListener clase con una opción para escribir la salida de seguimiento en la secuencia de salida estándar o la secuencia de error estándar.

NombreDescripción
System_CAPS_pubpropertyAttributes

Obtiene los atributos de agente de escucha de seguimiento personalizados que están definidos en el archivo de configuración de la aplicación.(Heredado de TraceListener.)

System_CAPS_pubpropertyFilter

Obtiene y establece el filtro de seguimiento para el agente de escucha de seguimiento.(Heredado de TraceListener.)

System_CAPS_pubpropertyIndentLevel

Obtiene o establece el nivel de sangría.(Heredado de TraceListener.)

System_CAPS_pubpropertyIndentSize

Obtiene o establece el número de espacios de una sangría.(Heredado de TraceListener.)

System_CAPS_pubpropertyIsThreadSafe

Obtiene un valor que indica si el agente de escucha de seguimiento es seguro para la ejecución de subprocesos.(Heredado de TraceListener.)

System_CAPS_pubpropertyName

Obtiene o establece un nombre para este objeto TraceListener.(Heredado de TraceListener.)

System_CAPS_protpropertyNeedIndent

Obtiene o establece un valor que indica si se va a aplicar sangría a los resultados.(Heredado de TraceListener.)

System_CAPS_pubpropertyTraceOutputOptions

Obtiene o establece las opciones de los resultados de seguimiento.(Heredado de TraceListener.)

System_CAPS_pubpropertyWriter

Obtiene o establece el escritor de texto que recibe el seguimiento o la depuración de salida.(Heredado de TextWriterTraceListener.)

NombreDescripción
System_CAPS_pubmethodClose()

Cierra la salida a la secuencia especificada para este agente de escucha de seguimiento.(Reemplaza a TextWriterTraceListener.Close()).

System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información pertinente necesaria para generar a un proxy utilizado para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject.)

System_CAPS_pubmethodDispose()

Libera todos los recursos usados por TraceListener.(Heredado de TraceListener.)

System_CAPS_protmethodDispose(Boolean)

Esta API admite la infraestructura de product y no está pensada para usarse directamente desde su código. Elimina esta TextWriterTraceListener objeto.(Heredado de TextWriterTraceListener.)

System_CAPS_pubmethodEquals(Object)

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

System_CAPS_pubmethodFail(String)

Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener.(Heredado de TraceListener.)

System_CAPS_pubmethodFail(String, String)

Emite un mensaje de error y un mensaje de error detallado para el agente de escucha que se crea al implementar la clase TraceListener.(Heredado de TraceListener.)

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object.)

System_CAPS_pubmethodFlush()

Vacía el búfer de salida para el Writer.(Heredado de TextWriterTraceListener.)

System_CAPS_pubmethodGetHashCode()

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

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject.)

System_CAPS_protmethodGetSupportedAttributes()

Obtiene los atributos personalizados admitidos por el agente de escucha de seguimiento.(Heredado de TraceListener.)

System_CAPS_pubmethodGetType()

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

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Crea una copia superficial del actual MarshalByRefObject objeto.(Heredado de MarshalByRefObject.)

System_CAPS_pubmethodToString()

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

System_CAPS_pubmethodTraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Escribe la información de seguimiento, un objeto de datos y la información de evento en los resultados específicos del agente de escucha.(Heredado de TraceListener.)

System_CAPS_pubmethodTraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Escribe la información de seguimiento, una matriz de objetos de datos y la información de evento en los resultados específicos del agente de escucha.(Heredado de TraceListener.)

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32)

Escribe la información de seguimiento y de evento en los resultados específicos del agente de escucha.(Heredado de TraceListener.)

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Escribe la información de seguimiento, un mensaje y la información de evento en los resultados específicos del agente de escucha.(Heredado de TraceListener.)

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Escribe la información de seguimiento, una matriz de objetos con formato y la información de evento en los resultados específicos del agente de escucha.(Heredado de TraceListener.)

System_CAPS_pubmethodTraceTransfer(TraceEventCache, String, Int32, String, Guid)

Escribe la información de seguimiento, un mensaje, una identidad de actividad relacionada y la información de evento en los resultados específicos del agente de escucha.(Heredado de TraceListener.)

System_CAPS_pubmethodWrite(Object)

Escribe el valor del método ToString del objeto en el agente de escucha que se crea al implementar la clase TraceListener.(Heredado de TraceListener.)

System_CAPS_pubmethodWrite(Object, String)

Escribe un nombre de categoría y el valor del método ToString del objeto en el agente de escucha que se crea al implementar la clase TraceListener.(Heredado de TraceListener.)

System_CAPS_pubmethodWrite(String)

Escribe un mensaje en esta instancia Writer.(Heredado de TextWriterTraceListener.)

System_CAPS_pubmethodWrite(String, String)

Escribe un nombre de categoría y un mensaje en el agente de escucha que se crea al implementar la clase TraceListener.(Heredado de TraceListener.)

System_CAPS_protmethodWriteIndent()

Escribe la sangría en el agente de escucha que se crea al implementar esta clase y restablece la propiedad NeedIndent en false.(Heredado de TraceListener.)

System_CAPS_pubmethodWriteLine(Object)

Escribe el valor del método ToString del objeto en el agente de escucha que se crea al implementar la clase TraceListener, seguido de un terminador de línea.(Heredado de TraceListener.)

System_CAPS_pubmethodWriteLine(Object, String)

Escribe un nombre de categoría y el valor del método ToString del objeto en el agente de escucha que se crea al implementar la clase TraceListener, seguidos de un terminador de línea.(Heredado de TraceListener.)

System_CAPS_pubmethodWriteLine(String)

Escribe un mensaje en esta instancia Writer seguido de un terminador de línea. El terminador de línea predeterminado es un retorno de carro seguido de un avance de línea (\r\n).(Heredado de TextWriterTraceListener.)

System_CAPS_pubmethodWriteLine(String, String)

Escribe un nombre de categoría y un mensaje en el agente de escucha que se crea al implementar la clase TraceListener, seguidos de un terminador de línea.(Heredado de TraceListener.)

Utilice la ConsoleTraceListener clase para escribir la traza y depuración de mensajes en la consola. Puede inicializar una ConsoleTraceListener objeto para escribir mensajes de seguimiento en el Console.Out secuencia o a la Console.Error secuencia.

System_CAPS_importantImportante

IDisposable interfaz. Cuando haya terminado de utilizar el tipo, debería eliminar, directa o indirectamente. Para deshacerse del tipo directamente, llame a su Dispose método en untry/catch bloque. Para deshacerse de él indirectamente, usar una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para obtener más información, consulte la sección "Uso de un objeto que implementa IDisposable" en el IDisposable tema de la interfaz.

Al realizar un seguimiento y salida de depuración está habilitado, el ConsoleTraceListener se escriben los mensajes a los especificados System.Console flujo, que es similar a la forma en que se escriben los mensajes con el Console.Write o Console.WriteLine métodos. En una aplicación de consola, el System.Console flujos de salida y error escriben mensajes en la ventana de consola existente o puede redirigir las secuencias para escribir en un System.IO.TextWriter instancia.

System_CAPS_noteNota

Si la consola no existe, como en una aplicación basada en Windows, no se muestran los mensajes escritos en la consola.

Agregar un ConsoleTraceListener objeto correspondiente Listeners colección si desea que los mensajes enviados a través de Trace, TraceSource, o Debug se escriban en la consola. Además, puede escribir mensajes directamente a la consola utilizando la Trace.Write o Trace.WriteLine métodos.

System_CAPS_noteNota

El Debug y Trace clases comparten la misma TraceListenerCollection colección, tiene acceso a través de sus respectivas Listeners Propiedades. Si agrega un ConsoleTraceListener de objeto a la colección utilizando una de estas clases, la otra clase automáticamente utiliza el mismo agente de escucha.

La mayoría de los compiladores habilitar el seguimiento y la salida a través de marcadores de compilación condicional de depuración. Si no habilita el seguimiento o la depuración, los mensajes escritos a través de la System.Diagnostics.Debug y System.Diagnostics.Trace se omiten eficazmente clases. La sintaxis para habilitar el seguimiento y la salida de depuración depende del compilador concreto; Si utiliza compiladores distintos de C# o Visual Basic, consulte la documentación del compilador.

  • Para habilitar la depuración en C#, agregue el /d: Debugmarca a la línea de comandos del compilador al compilar el código o puede agregar #define DEBUG en la parte superior del archivo. En Visual Basic, agregue el /d: DEBUG = True marca a la línea de comandos del compilador.

  • Para habilitar el seguimiento en C#, agregue el /d: Trace marca a la línea de comandos del compilador al compilar el código, o agregue #define TRACE en la parte superior del archivo. En Visual Basic, agregue el /d: TRACE = True marca a la línea de comandos del compilador.

Puede agregar un ConsoleTraceListener de objeto para el Listeners colección en su código, o bien puede agregar un ConsoleTraceListener objeto el Listeners colección a través del archivo de configuración de aplicación. Agregar la ConsoleTraceListener objeto en el código para escribir mensajes para una ruta de acceso de ejecución o sección de código específico. Agregar la ConsoleTraceListener objeto en el archivo de configuración de la aplicación para dirigir todos trace y debug mensajes a la consola mientras se ejecuta la aplicación.

Para escribir el seguimiento y depurar los mensajes en la consola para una sección de código específica, inicialice un ConsoleTraceListener de objeto y agréguelo a la Listeners colección. Instrumente la sección de código que contiene mensajes mediante la Trace o Debug las clases. Al final de la sección de código, quite el ConsoleTraceListener objeto desde el Listeners colección y llamar el Close método en el ConsoleTraceListener.

Para dirigir todo el seguimiento y mensajes en la consola de depuración mientras se ejecuta la aplicación, agregue un ConsoleTraceListener objeto en el archivo de configuración de la aplicación. Editar el archivo de configuración que corresponde al nombre de la aplicación o el archivo app.config en un Visual Studio 2005 proyecto. En este archivo, inserte un elemento para un ConsoleTraceListener.

En el ejemplo siguiente se agrega un ConsoleTraceListener objeto denominado configConsoleListener a la Listeners colección.

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="4">
      <listeners>
        <add name="configConsoleListener"           type="System.Diagnostics.ConsoleTraceListener" />
      </listeners>
    </trace>
  </system.diagnostics>
 </configuration>

Para obtener más información acerca de cómo agregar agentes de escucha de seguimiento en el archivo de configuración de aplicación, consulte Elemento <listeners> para <trace>.

En el ejemplo de código siguiente se implementa una aplicación de consola que consta de una clase con dos métodos públicos.

El Main método examina los argumentos de línea de comandos y determina si los resultados de seguimiento se deben dirigir a la secuencia de error estándar o la secuencia de salida estándar. Main crea e inicializa un ConsoleTraceListener objeto especificado Console flujo de salida y agrega este objeto a la colección de agente de escucha de seguimiento. A continuación, llama el WriteEnvironmentInfoToTrace método, que escribe los detalles sobre el entorno de ejecución y la configuración del agente de escucha de seguimiento a la salida de seguimiento.

Cuando se ejecuta la aplicación de ejemplo, los detalles de configuración de entorno y seguimiento se escriben en la secuencia de salida de consola especificada a través de la ConsoleTraceListener objeto.

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

.NET Framework
Disponible desde 2.0

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Volver al principio
Mostrar:
© 2016 Microsoft