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

ConsoleTraceListener (Clase)

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

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

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

El tipo ConsoleTraceListener expone los siguientes miembros.

  NombreDescripción
Método públicoConsoleTraceListener()Inicializa una nueva instancia de la clase ConsoleTraceListener con los resultados de seguimiento escritos en el flujo de salida estándar.
Método públicoConsoleTraceListener(Boolean)Inicializa una nueva instancia de la clase ConsoleTraceListener con una opción para escribir el resultado de seguimiento en el flujo de salida estándar o en el flujo de error estándar.
Arriba

  NombreDescripción
Propiedad públicaAttributesObtiene los atributos de agente de escucha de seguimiento personalizados que están definidos en el archivo de configuración de la aplicación. (Se hereda de TraceListener).
Propiedad públicaFilterObtiene y establece el filtro de seguimiento para el agente de escucha de seguimiento. (Se hereda de TraceListener).
Propiedad públicaIndentLevelObtiene o establece el nivel de sangría. (Se hereda de TraceListener).
Propiedad públicaIndentSizeObtiene o establece el número de espacios de una sangría. (Se hereda de TraceListener).
Propiedad públicaIsThreadSafeObtiene un valor que indica si el agente de escucha de seguimiento es seguro para la ejecución de subprocesos. (Se hereda de TraceListener).
Propiedad públicaNameObtiene o establece un nombre para este objeto TraceListener. (Se hereda de TraceListener).
Propiedad protegidaNeedIndentObtiene o establece un valor que indica si se va a aplicar sangría a los resultados. (Se hereda de TraceListener).
Propiedad públicaTraceOutputOptionsObtiene o establece las opciones de los resultados de seguimiento. (Se hereda de TraceListener).
Propiedad públicaWriterObtiene o establece el escritor de texto que recibe los resultados de la traza o la depuración. (Se hereda de TextWriterTraceListener).
Arriba

  NombreDescripción
Método públicoCloseCierra la salida a la secuencia especificada para este agente de escucha de seguimiento. (Invalida a TextWriterTraceListener.Close()).
Método públicoCreateObjRefCrea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método públicoDispose()Libera todos los recursos utilizados por TraceListener. (Se hereda de TraceListener).
Método protegidoDispose(Boolean)Infraestructura. Desecha este objeto TextWriterTraceListener. (Se hereda de TextWriterTraceListener).
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método públicoFail(String)Emite un mensaje de error para el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método públicoFail(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. (Se hereda de TraceListener).
Método protegidoFinalize 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úblicoFlushVacía el búfer de resultados de la propiedad Writer. (Se hereda de TextWriterTraceListener).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetLifetimeServiceRecupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoGetSupportedAttributesObtiene los atributos personalizados admitidos por el agente de escucha de seguimiento. (Se hereda de TraceListener).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoInitializeLifetimeServiceObtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegidoMemberwiseClone() Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoMemberwiseClone(Boolean)Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método públicoToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoTraceData(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. (Se hereda de TraceListener).
Método públicoTraceData(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. (Se hereda de TraceListener).
Método públicoTraceEvent(TraceEventCache, String, TraceEventType, Int32)Escribe la información de seguimiento y de evento en los resultados específicos del agente de escucha. (Se hereda de TraceListener).
Método públicoTraceEvent(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. (Se hereda de TraceListener).
Método públicoTraceEvent(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. (Se hereda de TraceListener).
Método públicoTraceTransferEscribe 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. (Se hereda de TraceListener).
Método públicoWrite(Object)Escribe el valor del método ToString del objeto en el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método públicoWrite(String)Escribe un mensaje en la propiedad Writer de esta instancia. (Se hereda de TextWriterTraceListener).
Método públicoWrite(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. (Se hereda de TraceListener).
Método públicoWrite(String, String)Escribe un nombre de categoría y un mensaje en el agente de escucha que se crea al implementar la clase TraceListener. (Se hereda de TraceListener).
Método protegidoWriteIndentEscribe la sangría en el agente de escucha que se crea al implementar esta clase y restablece la propiedad NeedIndent en false. (Se hereda de TraceListener).
Método públicoWriteLine(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. (Se hereda de TraceListener).
Método públicoWriteLine(String)Escribe en la propiedad Writer de esta instancia un mensaje seguido de un terminador de línea. El terminador de línea predeterminado corresponde a un retorno de carro seguido de un avance de línea (\r\n). (Se hereda de TextWriterTraceListener).
Método públicoWriteLine(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. (Se hereda de TraceListener).
Método públicoWriteLine(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. (Se hereda de TraceListener).
Arriba

Utilice la clase ConsoleTraceListener para escribir los mensajes de seguimiento y de depuración en la consola. Se puede inicializar un objeto ConsoleTraceListener para escribir los mensajes de seguimiento en la secuencia de Console.Out o la secuencia de Console.Error.

Nota importanteImportante

interfaz deIDisposable . Cuando haya terminado de utilizar el tipo, se debe eliminar de directa o indirectamente. Para desechar de tipo directamente, llame al método de Dispose en un bloque detry/decatch . Para desechar de indirectamente, utilice una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para obtener más información, vea “Uso de objeto que implementa sección IDisposable” en el tema de la interfaz de IDisposable .

Cuando está habilitado el resultado de seguimiento y de depuración, los mensajes de ConsoleTraceListener se escriben en la secuencia de System.Console especificada, lo que es similar a la manera en que se escriben los mensajes con los métodos Console.Write y Console.WriteLine. En una aplicación de consola, las secuencias de resultados de la System.Console y las secuencias de error escriben mensajes en la ventana de consola existente, o bien, se pueden redirigir las secuencias para que se escriban en una instancia de System.IO.TextWriter.

NotaNota

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

Agregue un objeto ConsoleTraceListener a la colección Listeners adecuada si desea que los mensajes escritos a través de Trace, TraceSource o Debug se escriban en la consola. Además, los mensajes se pueden escribir directamente en la consola mediante el método Trace.Write o Trace.WriteLine.

NotaNota

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

La mayoría de los compiladores habilitan los resultados de seguimiento y de depuración a través de marcadores de compilación condicional. Si no se habilita la traza o la depuración, se omiten eficazmente los mensajes escritos a través de las clases System.Diagnostics.Debug y System.Diagnostics.Trace. La sintaxis para habilitar los resultados de seguimiento y de depuración es específica de cada compilador; si utiliza compiladores distintos de C# o Visual Basic, consulte la documentación correspondiente al compilador.

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

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

Se puede agregar un objeto ConsoleTraceListener a la colección Listeners en el código o se puede agregar un objeto ConsoleTraceListener a la colección Listeners a través del archivo de configuración de la aplicación. Agregue el objeto ConsoleTraceListener en el código para escribir mensajes para una sección de código o una ruta de ejecución específica. Agregue el objeto ConsoleTraceListener en el archivo de configuración de la aplicación para dirigir todos los mensajes de seguimiento y de depuración a la consola durante la ejecución de la aplicación.

Si desea escribir los mensajes de seguimiento y de depuración en la consola para una sección de código específica, inicialice un objeto ConsoleTraceListener y agréguelo a la colección Listeners. Instrumente la sección de código que contiene mensajes mediante la clase Trace o Debug. Al final de la sección de código, quite el objeto ConsoleTraceListener de la colección Listeners y llame al método Close en ConsoleTraceListener.

Para dirigir todos los mensajes de seguimiento y de depuración a la consola durante la ejecución de la aplicación, agregue un objeto ConsoleTraceListener al archivo de configuración de la aplicación. Edite el archivo de configuración correspondiente al nombre de la aplicación o el archivo app.config en un proyecto de Visual Studio 2005. En este archivo, inserte un elemento para un ConsoleTraceListener.

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

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

Para obtener información detallada sobre cómo agregar agentes de escucha de seguimiento en el archivo de configuración, vea Elemento <listeners> para <trace>.

NotaNota

El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el siguiente valor de propiedad Resources: Synchronization. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación en SQL Server y atributos de protección de host.

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

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

Durante la ejecución de la aplicación de ejemplo, los detalles sobre el entorno y la configuración de seguimiento se escriben en el flujo de salida de la consola especificado a través del objeto ConsoleTraceListener.

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

.NET Framework

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

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

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.

Todos los miembros static (Shared en Visual Basic) públicos 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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft