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 FileLogTraceListener

 

Proporciona un agente de escucha simple que dirige la salida al archivo de registro.

Espacio de nombres:   Microsoft.VisualBasic.Logging
Ensamblado:  Microsoft.VisualBasic (en Microsoft.VisualBasic.dll)

System::Object
  System::MarshalByRefObject
    System.Diagnostics::TraceListener
      Microsoft.VisualBasic.Logging::FileLogTraceListener

[ComVisibleAttribute(false)]
public ref class FileLogTraceListener : TraceListener

NombreDescripción
System_CAPS_pubmethodFileLogTraceListener()

Inicializa una nueva instancia de la FileLogTraceListener clase con el nombre predeterminado.

System_CAPS_pubmethodFileLogTraceListener(String^)

Inicializa una nueva instancia de la FileLogTraceListener clase con el nombre proporcionado.

NombreDescripción
System_CAPS_pubpropertyAppend

Determina si se va a anexar la salida al archivo actual o escribir en un archivo nuevo.

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_pubpropertyAutoFlush

Indica si se permite o no la escritura en la secuencia de archivo de registro vacía el búfer.

System_CAPS_pubpropertyBaseFileName

Obtiene o establece el nombre base para los archivos de registro, que se utiliza para crear el nombre completo del archivo de registro.

System_CAPS_pubpropertyCustomLocation

Obtiene o establece el directorio del archivo de registro cuando el Location propiedad está establecida en Custom.

System_CAPS_pubpropertyDelimiter

Obtiene o establece el delimitador utilizado para delimitar los campos en un mensaje de registro.

System_CAPS_pubpropertyDiskSpaceExhaustedBehavior

Determina qué hacer cuando se escribe en el archivo de registro y hay menos espacio libre en disco que el especificado por el ReserveDiskSpace propiedad.

System_CAPS_pubpropertyEncoding

Obtiene o establece la codificación que se utilizará al crear un nuevo archivo de registro.

System_CAPS_pubpropertyFilter

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

System_CAPS_pubpropertyFullLogFileName

Obtiene el nombre completo del archivo de registro actual.

System_CAPS_pubpropertyIncludeHostName

Indica si el nombre de host del equipo de registro debe incluirse en la salida.

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_pubpropertyLocation

Obtiene o establece la ubicación de los archivos de registro.

System_CAPS_pubpropertyLogFileCreationSchedule

Determina qué fecha se debe incluir en los nombres de los archivos de registro.

System_CAPS_pubpropertyMaxFileSize

Obtiene o establece el tamaño máximo permitido del archivo de registro, en bytes.

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_pubpropertyReserveDiskSpace

Obtiene o establece la cantidad de espacio libre en disco, en bytes, es necesario antes de que los mensajes pueden escribirse en el archivo de registro.

System_CAPS_pubpropertyTraceOutputOptions

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

NombreDescripción
System_CAPS_pubmethodClose()

Cierra la secuencia subyacente para el archivo de registro actual y libera todos los recursos asociados a la secuencia actual.(Invalida TraceListener::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)

Cierra la secuencia subyacente y, opcionalmente, libera los recursos administrados.(Invalida TraceListener::Dispose(Boolean)).

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

Vuelca la secuencia subyacente que escribe en el archivo de registro actual.(Invalida TraceListener::Flush()).

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 de configuración XML personalizados admitidos por el agente de escucha de seguimiento.(Invalida TraceListener::GetSupportedAttributes()).

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 e información de evento en el archivo de salida o la secuencia.(Invalida TraceListener::TraceData(TraceEventCache^, String^, TraceEventType, Int32, Object^)).

System_CAPS_pubmethodTraceData(TraceEventCache^, String^, TraceEventType, Int32, array<Object^>^)

Escribe información de seguimiento, una matriz de objetos de datos y la información de evento en el archivo de salida o la secuencia.(Invalida TraceListener::TraceData(TraceEventCache^, String^, TraceEventType, Int32, array<Object^>^)).

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 información de seguimiento, una información de mensajes y de eventos a la secuencia o archivo de salida.(Invalida TraceListener::TraceEvent(TraceEventCache^, String^, TraceEventType, Int32, String^)).

System_CAPS_pubmethodTraceEvent(TraceEventCache^, String^, TraceEventType, Int32, String^, array<Object^>^)

Escribe información de seguimiento, una matriz de objetos y la información de evento en la secuencia o archivo de salida con formato.(Invalida TraceListener::TraceEvent(TraceEventCache^, String^, TraceEventType, Int32, String^, array<Object^>^)).

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 textual en el disco, sin información de contexto adicional.(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 un mensaje textual en disco, seguida del terminador de línea actual, sin ninguna información de contexto adicional.(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).

La FileLogTraceListener clase proporciona funciones de mantenimiento automatizadas para almacenar los archivos de registro según sea necesario, diariamente o por aplicación. Esta funcionalidad de archivado automático ayuda a reducir las responsabilidades de mantenimiento de los desarrolladores y administradores.

Una instancia de FileLogTraceListener pueden agregarse a la Debug::Listeners o Trace::Listeners colecciones para redirigir el resultado de registro a un archivo de texto. También pueden agregar instancias de esta clase para My.Application.Log o My.Log (para aplicaciones Web) en Visual Basic aplicaciones. Para obtener más información, vea Tutorial: Cambiar el lugar en el que My.Application.Log escribe la información (Visual Basic).

Las principales características de esta clase son:

  1. Funcionalidad de archivado. Los archivos de registro generados por esta clase se denominan según el nombre base y la fecha, junto con un número para distinguir el archivo de registro de las versiones sucesivas del registro. Se crean nuevos archivos de registro según sea necesario.

    La forma explícita del nombre de archivo es baseName[-dateStamp] [-version]. log, donde:

    • El baseName parte es el nombre de registro fundamental, especificado por el BaseFileName propiedad.

    • El dateStamp parte tiene el formato "Aaaa-MM-DD" y se muestra cuando LogFileCreationSchedule es Daily o Weekly.

    • Si se necesita más de un archivo de registro con el mismo baseName y dateStamp, la version parte positivo Integer, se agrega al nombre de archivo.

  2. Varias instancias de clase. Si una instancia de la FileLogTraceListener clase escribe en un archivo que está en uso:

    • La clase comparte el archivo si está utilizando otra instancia de la FileLogTraceListener clase en el mismo proceso.

    • La clase crea un nuevo archivo de registro con el siguiente nombre disponible si el archivo está siendo utilizado por otro proceso.

  3. Seguridad para subprocesos. La FileLogTraceListener clase es segura para subprocesos. Esto permite escribir sin ningún riesgo mensajes en el registro desde varios subprocesos sin utilizar bloqueos.

Ubicación del archivo de registro

  • El Location propiedad toma un LogFileLocation enumeración para especificar uno de los directorios típicos para escribir el archivo de registro.

  • Para escribir el registro a otra ubicación, establezca el CustomLocation propiedad en esa ubicación.

Nombre de archivo de registro

  • El nombre base del archivo de registro especificado por el BaseFileName propiedad.

  • El nombre de archivo de registro actual se puede leer desde el FullLogFileName propiedad. Se deriva de varias otras propiedades y el estado actual de los registros del sistema de archivos.

Mantenimiento del registro

  • La frecuencia mínima para la creación de nuevos archivos de registro viene determinada por la LogFileCreationSchedule propiedad. Cuando el valor es Daily o Weekly, se crea un nuevo archivo de registro al menos una vez cada día o semana, y una marca de fecha se incorpora en el FullLogFileName nombre.

  • El tamaño máximo (en bytes) del archivo de registro está determinado por la MaxFileSize propiedad. Si el tamaño del archivo de registro supera este tamaño, escribe en el registro de mensajes adicionales se descarta y, dependiendo de la DiskSpaceExhaustedBehavior propiedad, se produce una excepción.

  • El ReserveDiskSpace propiedad determina cuánto espacio libre (en bytes) debe estar disponible. Esto ayuda a garantizar que la FileLogTraceListener clase no consuma todo el espacio disponible en disco. Utilice la DiskSpaceExhaustedBehavior propiedad para especificar el comportamiento de registro se escribe cuando hay menos de ReserveDiskSpace bytes libres.

Configuración de salida del archivo de registro

  • El AutoFlush propiedad especifica si la secuencia subyacente debe vaciarse automáticamente después de cada escritura en el archivo de registro.

  • El Append propiedad especifica si se va a anexar mensajes en el archivo de registro actual, si permite o escribirlos en un nuevo archivo de registro.

  • El Delimiter propiedad especifica la cadena que se va a utilizar para delimitar los campos en un mensaje de registro.

  • El Encoding propiedad especifica la codificación que se utilizará al crear un nuevo archivo de registro.

Salida de archivo de registro

  • El TraceData y TraceEvent métodos escriben mensajes en el archivo de registro. Estos métodos comprueban la LogFileCreationSchedule propiedad, junto con los registros existentes con el mismo nombre base para determinar si se debe crear un nuevo registro.

  • El Flush método vuelca todos los mensajes actualmente en el búfer de salida al archivo de registro.

  • El Close método cierra el archivo de registro para que se puede usar por otros procesos.

Habilitar salida

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 puede agregar #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 establecer el nivel del agente de escucha, edite el archivo de configuración 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 se debe dar formato como en el ejemplo siguiente.

Para que ejecutar este ejemplo, debe proporcionar el nombre completo del ensamblado. Para obtener información acerca de cómo obtener el nombre de ensamblado completo, vea Nombres de ensamblado.

<configuration>
    <system.diagnostics>
        <sharedListeners>
            <add name="FileLog"
                type="Microsoft.VisualBasic.Logging.FileLogTraceListener, 
                      Microsoft.VisualBasic, Version=8.0.0.0, 
                      Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, 
                      processorArchitecture=MSIL" 
                initializeData="FileLogWriter"/>
        </sharedListeners>
    </system.diagnostics>
</configuration>

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: