FileLogTraceListener.Append Propiedad

  • Referencia

Definición

Espacio de nombres:
Microsoft.VisualBasic.Logging
Ensamblado:
Microsoft.VisualBasic.dll
Ensamblado:
Microsoft.VisualBasic.Forms.dll

Determina si el resultado se va a anexar al archivo actual o se va a escribir en un archivo nuevo o existente.

public:
 property bool Append { bool get(); void set(bool value); };
public bool Append { get; set; }
member this.Append : bool with get, set
Public Property Append As Boolean

Valor de propiedad

Boolean

Un valor de tipo Boolean; True indica que el resultado se anexa al archivo actual y False indica que el resultado se escribe en un nuevo archivo. El valor predeterminado de esta propiedad es True.

Comentarios

Cuando la Append propiedad es True, el archivo de registro se abre en Append modo para mantener los registros existentes. La posición de escritura actual comienza al final del archivo, de modo que los registros nuevos se anexan al final del archivo.

Cuando la Append propiedad es False, el archivo de registro se abre en Truncate modo , donde se eliminan todos los datos de registro cuando se abre el archivo de registro. FileLogTraceListener Elimina el contenido existente del archivo de registro una vez después de establecer False el Append valor correcto en o el archivo se abre y antes de escribir el primer registro. Después, FileLogTraceListener anexa datos de seguimiento adicionales al final del archivo. Si se cierra la FileLogTraceListener instancia y, a continuación, se vuelve a abrir mientras Append se establece en False, borra los datos del archivo de registro antes de escribir registros adicionales. Esto puede provocar que falten datos, especialmente si establece el valor de la Append propiedad False en en un archivo de configuración.

Este comportamiento se invalida en los escenarios siguientes:

  • Otro proceso bloquea el archivo de salida. Se crea un nuevo archivo de registro con un número de versión que se incorpora en el FullLogFileName nombre.

  • El tamaño del archivo actual es mayor que lo que permite la MaxFileSize propiedad. Se descartan mensajes adicionales. Dependiendo de la DiskSpaceExhaustedBehavior propiedad , se produce una excepción.

  • El nombre de archivo existente no está actualizado según la programación de creación de registros especificada por la LogFileCreationSchedule propiedad . Se crea un nuevo archivo de registro. La marca de fecha se incorpora al FullLogFileName nombre.

Se aplica a

Consulte también