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 DefaultTraceListener

 

Proporciona los métodos de salida de forma predeterminada y el comportamiento para el seguimiento.

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

System.Object
  System.MarshalByRefObject
    System.Diagnostics.TraceListener
      System.Diagnostics.DefaultTraceListener

[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)]
public class DefaultTraceListener : TraceListener

NombreDescripción
System_CAPS_pubmethodDefaultTraceListener()

Inicializa una nueva instancia de la DefaultTraceListener de clase con "Default" como su Name valor de propiedad.

NombreDescripción
System_CAPS_pubpropertyAssertUiEnabled

Obtiene o establece un valor que indica si la aplicación se ejecuta en modo de interfaz de usuario.

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_pubpropertyLogFileName

Obtiene o establece el nombre de un archivo de registro para escribir el seguimiento de mensajes o de depuración.

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

NombreDescripción
System_CAPS_pubmethodClose()

Cuando se reemplaza en una clase derivada, se cierra el flujo de salida para que ya no reciba resultados de la traza o de la depuración.(Heredado de TraceListener).

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 que usa TraceListener.(Heredado de TraceListener).

System_CAPS_protmethodDispose(Boolean)

Libera los recursos no administrados que usa TraceListener y libera los recursos administrados de forma opcional.(Heredado de TraceListener).

System_CAPS_pubmethodEquals(Object)

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

System_CAPS_pubmethodFail(String)

Emite o muestra un mensaje y un seguimiento de pila para una aserción que siempre produce un error.(Invalida TraceListener.Fail(String)).

System_CAPS_pubmethodFail(String, String)

Emite o muestra mensajes detallados y un seguimiento de pila para una aserción que siempre produce un error.(Invalida TraceListener.Fail(String, String)).

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()

Cuando se reemplaza en una clase derivada, vacía el búfer de resultados.(Heredado de TraceListener).

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()

Devuelve 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 el resultado en la OutputDebugString (función) y a la Debugger.Log (método).(Invalida TraceListener.Write(String)).

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 el resultado en la OutputDebugString (función) y a la Debugger.Log método, seguido por un retorno de carro y salto de línea (\r\n).(Invalida TraceListener.WriteLine(String)).

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

Una instancia de esta clase se agrega automáticamente a la Debug.Listeners y Trace.Listeners las colecciones. Agregar explícitamente un segundo DefaultTraceListener causas duplicar mensajes en la ventana de salida del depurador y los cuadros de mensajes para las aserciones.

De forma predeterminada, la Write y WriteLine métodos envían el mensaje a Win32 OutputDebugString (función) y a la Debugger.Log (método). Para obtener información sobre la OutputDebugString de función, vea Platform SDK o MSDN.

El Fail método, de forma predeterminada, muestra un cuadro de mensaje cuando la aplicación se ejecuta en un modo de interfaz de usuario; también envía el mensaje utilizando WriteLine.

System_CAPS_noteNota

La presentación del cuadro de mensaje para Assert y Fail llamadas al método depende de la presencia de la DefaultTraceListener. Si el DefaultTraceListener no está en el Listeners no se muestra la colección, el cuadro de mensaje. El DefaultTraceListener se puede quitar el < clear > elemento, por el elemento < remove >, o mediante una llamada a la Clear método en el Listeners propiedad (System.Diagnostics.Trace.Listeners.Clear()).

Debe habilitar el seguimiento o la depuración para utilizar un agente de escucha de seguimiento. La sintaxis siguiente es específica del compilador. 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:DEBUG marca a la línea de comandos del compilador al compilar el código, o agregue #define DEBUG a 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 a la parte superior del archivo. En Visual Basic, agregue el /d:TRACE=True marca a la línea de comandos del compilador.

Para agregar un agente de escucha de seguimiento, modifique el archivo de configuración que corresponde al nombre de la aplicación. En este archivo, puede agregar un agente de escucha, establecer su tipo y sus parámetros, quitar un agente de escucha o borrar todos los agentes de escucha previamente establecidos por la aplicación. El archivo de configuración debería tener el formato similar al ejemplo siguiente:

<configuration>
<system.diagnostics>
  <trace autoflush="false" indentsize="4">
    <listeners>
      <remove name="Default" />
      <add name="myListener"  type="System.Diagnostics.TextWriterTraceListener"    initializeData="c:\myListener.log" />
    </listeners>
  </trace>
</system.diagnostics>
</configuration>

En el ejemplo de código siguiente se calcula binomial coeficientes, que son los valores utilizados en probabilidad y estadística. Este ejemplo utiliza un DefaultTraceListener para resultados de seguimiento y registro de errores. Crea un nuevo DefaultTraceListener, lo agrega a la Trace.Listeners colección y establece el LogFileName propiedad al archivo de registro especificado en los argumentos de línea de comandos.

Si se detecta un error al procesar el parámetro de entrada, o si el CalcBinomial función produce una excepción, el Fail método registra y muestra un mensaje de error. Si el AssertUiEnabled propiedad es false, el mensaje de error también se escribe en la consola. Cuando el resultado se calcula correctamente, el Write(String) y WriteLine(String) métodos escriben los resultados en el archivo de registro.

El Fail, Write, y WriteLine métodos hacen que la información de seguimiento se escriban únicamente a la DefaultTraceListener. Para escribir información de seguimiento en todos los agentes de escucha de la Trace.Listeners colección, utilice el Fail, Write, y WriteLine métodos de la Trace clase.

using System;
using System.Diagnostics;
using Microsoft.VisualBasic;

class Binomial
{

    // args(0) is the number of possibilities for binomial coefficients.
    // args(1) is the file specification for the trace log file.
    public static void Main(string[] args)
    {

        decimal possibilities;
        decimal iter;

        // Remove the original default trace listener.
        Trace.Listeners.RemoveAt(0);

        // Create and add a new default trace listener.
        DefaultTraceListener defaultListener;
        defaultListener = new DefaultTraceListener();
        Trace.Listeners.Add(defaultListener);

        // Assign the log file specification from the command line, if entered.
        if (args.Length>=2)
        {
            defaultListener.LogFileName = args[1];
        }

        // Validate the number of possibilities argument.
        if (args.Length>=1)

            // Verify that the argument is a number within the correct range.
        {
            try
            {
                const decimal MAX_POSSIBILITIES = 99;
                possibilities = Decimal.Parse(args[0]);
                if (possibilities<0||possibilities>MAX_POSSIBILITIES)
                {
                    throw new Exception(String.Format("The number of possibilities must " +
                        "be in the range 0..{0}.", MAX_POSSIBILITIES));
                }
            }
            catch(Exception ex)
            {
                string failMessage = String.Format("\"{0}\" " +
                    "is not a valid number of possibilities.", args[0]);
                defaultListener.Fail(failMessage, ex.Message);
                if (!defaultListener.AssertUiEnabled)
                {
                    Console.WriteLine(failMessage+ "\n" +ex.Message);
                }
                return;
            }
        }
        else
        {
            // Report that the required argument is not present.
            const string ENTER_PARAM = "Enter the number of " +
                      "possibilities as a command line argument.";
            defaultListener.Fail(ENTER_PARAM);
            if (!defaultListener.AssertUiEnabled)
            {
                Console.WriteLine(ENTER_PARAM);
            }
            return;
        }

        for(iter=0; iter<=possibilities; iter++)
        {
            decimal result;
            string binomial;

            // Compute the next binomial coefficient and handle all exceptions.
            try
            {
                result = CalcBinomial(possibilities, iter);
            }
            catch(Exception ex)
            {
                string failMessage = String.Format("An exception was raised when " +
                    "calculating Binomial( {0}, {1} ).", possibilities, iter);
                defaultListener.Fail(failMessage, ex.Message);
                if (!defaultListener.AssertUiEnabled)
                {
                    Console.WriteLine(failMessage+ "\n" +ex.Message);
                }
                return;
            }

            // Format the trace and console output.
            binomial = String.Format("Binomial( {0}, {1} ) = ", possibilities, iter);
            defaultListener.Write(binomial);
            defaultListener.WriteLine(result.ToString());
            Console.WriteLine("{0} {1}", binomial, result);
        }
    }

    public static decimal CalcBinomial(decimal possibilities, decimal outcomes)
    {

        // Calculate a binomial coefficient, and minimize the chance of overflow.
        decimal result = 1;
        decimal iter;
        for(iter=1; iter<=possibilities-outcomes; iter++)
        {
            result *= outcomes+iter;
            result /= iter;
        }
        return result;
    }
}

.NET Framework
Disponible desde 1.1

Esta clase es segura para subprocesos.

Volver al principio
Mostrar: