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

FileLogTraceListener (Clase)

Proporciona un agente de escucha simple que dirige el resultado del registro a un archivo.

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

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

[ComVisibleAttribute(false)]
public class FileLogTraceListener : TraceListener

El tipo FileLogTraceListener expone los siguientes miembros.

  NombreDescripción
Método públicoFileLogTraceListener()Inicializa una nueva instancia de la clase FileLogTraceListener con el nombre predeterminado.
Método públicoFileLogTraceListener(String)Inicializa una nueva instancia de la clase FileLogTraceListener con el nombre proporcionado.
Arriba

  NombreDescripción
Propiedad públicaAppendDetermina si el resultado se va a anexar al archivo actual o escribir en un nuevo archivo.
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úblicaAutoFlushIndica si al escribir en el archivo de registro se vacía el búfer.
Propiedad públicaBaseFileNameObtiene o establece el nombre base de los archivos de registro, que se utiliza para crear su nombre completo.
Propiedad públicaCustomLocationObtiene o establece el directorio del archivo de registro cuando el valor de la propiedad Location se establece en Custom.
Propiedad públicaDelimiterObtiene o establece el delimitador utilizado para delimitar los campos en un mensaje de registro.
Propiedad públicaDiskSpaceExhaustedBehaviorDetermina qué debe hacerse cuando se escribe en el archivo de registro y hay menos espacio disponible en disco que el especificado por la propiedad ReserveDiskSpace.
Propiedad públicaEncodingObtiene o establece la codificación que se va a utilizar al crear un nuevo archivo de registro.
Propiedad públicaFilterObtiene y establece el filtro de seguimiento para el agente de escucha de seguimiento. (Se hereda de TraceListener).
Propiedad públicaFullLogFileNameObtiene el nombre completo del archivo de registro actual.
Propiedad públicaIncludeHostNameIndica si el nombre de host del equipo de registro debe incluirse en el resultado.
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úblicaLocationObtiene o establece la ubicación de los archivos de registro.
Propiedad públicaLogFileCreationScheduleDetermina qué fecha se va a incluir en los nombres de los archivos de registro.
Propiedad públicaMaxFileSizeObtiene o establece el tamaño máximo permitido del archivo de registro, expresado en bytes.
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úblicaReserveDiskSpaceObtiene o establece la cantidad necesaria de espacio disponible en disco, en bytes, para que los mensajes puedan escribirse en el archivo de registro.
Propiedad públicaTraceOutputOptionsObtiene o establece las opciones de los resultados de seguimiento. (Se hereda de TraceListener).
Arriba

  NombreDescripción
Método públicoCloseCierra la secuencia subyacente del archivo de registro actual y libera los recursos asociados a la secuencia actual. (Invalida a TraceListener.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)Cierra la secuencia subyacente y, de manera opcional, libera los recursos administrados. (Invalida a TraceListener.Dispose(Boolean)).
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 la secuencia subyacente que escribe en el archivo de registro actual. (Invalida a TraceListener.Flush()).
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 de configuración XML personalizados que admite el agente de escucha de seguimiento. (Invalida a TraceListener.GetSupportedAttributes()).
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 el archivo de salida o el flujo de salida. (Invalida a TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object)).
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 el archivo de salida o el flujo de salida. (Invalida a TraceListener.TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])).
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 el archivo de salida o el flujo de salida. (Invalida a TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)).
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 el archivo de salida o el flujo de salida. (Invalida a TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])).
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 literalmente un mensaje en el disco, sin información de contexto adicional. (Invalida a TraceListener.Write(String)).
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 un mensaje literal en el disco, seguido del terminador de línea actual y sin ninguna información de contexto adicional. (Invalida a TraceListener.WriteLine(String)).
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

La clase FileLogTraceListener proporciona las 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.

Se puede agregar una instancia de FileLogTraceListener a las colecciones Debug.Listeners o Trace.Listeners para redirigir el resultado de registro a un archivo de texto. También se pueden agregar instancias de esta clase a My.Application.Log o My.Log (para aplicaciones web) en aplicaciones Visual Basic. Para obtener más información, consulte 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. A los archivos de registro generados por esta clase se les asigna un nombre basándose en el nombre base y la fecha, junto con un número para diferenciar el archivo de registro de las versiones sucesivas del registro. Se crean nuevos archivos de registro según sean necesarios.

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

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

    • dateStamp 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 los mismos valores de baseName y dateStamp, se agrega version, un valor positivo de tipo Integer, al nombre de archivo.

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

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

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

  3. Seguridad para subprocesos. La clase FileLogTraceListener 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

  • La propiedad Location toma una enumeración LogFileLocation para especificar uno de los directorios comunes donde se escribe el archivo de registro.

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

Nombre del archivo de registro

  • La propiedad BaseFileName especifica el nombre base del archivo de registro.

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

Mantenimiento de registros

  • La propiedad LogFileCreationSchedule determina la frecuencia mínima con la que se crean nuevos archivos de registro. Cuando el valor es Daily o Weekly, se crea un nuevo archivo de registro al menos una vez al día o a la semana y se incluye una marca de fecha en el nombre FullLogFileName.

  • La propiedad MaxFileSize determina el tamaño máximo (en bytes) del archivo de registro. Si el tamaño del archivo de registro sobrepasa este valor, se descartan los mensajes adicionales que se escriben en el registro y, según el valor de la propiedad DiskSpaceExhaustedBehavior, se genera una excepción.

  • La propiedad ReserveDiskSpace determina cuánto espacio disponible (en bytes) debe haber. Esto ayuda a garantizar que la clase FileLogTraceListener no utilizará todo el espacio disponible en disco. Utilice la propiedad DiskSpaceExhaustedBehavior para especificar el comportamiento de las escrituras de registro cuando el espacio disponible, en bytes, es menor que ReserveDiskSpace.

Configuración de salida del archivo de registro

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

  • La propiedad Append especifica si los mensajes se van a anexar al archivo de registro actual, si está permitido, o si se van a escribir en un nuevo archivo de registro.

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

  • La propiedad Encoding especifica la codificación que se va a utilizar al crear un nuevo archivo de registro.

Salida del archivo de registro

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

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

  • El método Close cierra el archivo de registro para que otros procesos puedan utilizarlo.

Habilitar la salida

Es preciso habilitar la traza o la depuración para poder utilizar un agente de escucha de traza. La sintaxis siguiente es específica del compilador. Si se utilizan compiladores que no sean C# o Visual Basic, consulte la documentación del 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 la marca /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 la marca /d:TRACE=True 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, se podrá agregar un agente de escucha, establecer el tipo de agente y sus parámetros, quitar un agente o borrar todos los agentes definidos previamente por la aplicación. El archivo de configuración debería tener el formato que se muestra en el siguiente ejemplo.

Para poder ejecutar este ejemplo, deberá proporcionar el nombre completo del ensamblado. Para obtener información acerca de cómo obtener el nombre completo del ensamblado, 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

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