FileLogTraceListener.Append Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.VisualBasic.Logging
Assembly:
Microsoft.VisualBasic.dll
Assembly:
Microsoft.VisualBasic.Forms.dll

Determina se aggiungere l'output al file corrente o se scriverlo in un file nuovo o esistente.

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

Valore della proprietà

Boolean

Boolean, con valore True che indica che l'output viene aggiunto al file corrente e False che indica che verrà scritto in un nuovo file. L'impostazione predefinita di questa proprietà è True.

Commenti

Quando la Append proprietà è True, il file di log viene aperto in Append modalità , per mantenere i log esistenti. La posizione di scrittura corrente inizia alla fine del file, in modo che tutti i nuovi log vengano aggiunti alla fine del file.

Quando la Append proprietà è False, il file di log viene aperto in Truncate modalità , in cui tutti i dati di log vengono eliminati all'apertura del file di log. Elimina FileLogTraceListener il contenuto esistente del file di log una volta dopo l'impostazione AppendFalse corretta su o il file viene aperto e prima di scrivere il primo log. Successivamente, FileLogTraceListener aggiunge ulteriori dati di traccia alla fine del file. Se l'istanza FileLogTraceListener viene chiusa e quindi riaperta mentre Append è impostata su False, cancella i dati del file di log prima di scrivere log aggiuntivi. Ciò può causare dati mancanti, in particolare se si imposta il valore della Append proprietà su False in un file di configurazione.

Questo comportamento viene sottoposto a override negli scenari seguenti:

  • Il file di output è bloccato da un altro processo. Viene creato un nuovo file di log con un numero di versione incorporato nel FullLogFileName nome.

  • Le dimensioni correnti del file sono maggiori di quelle consentite dalla MaxFileSize proprietà. I messaggi aggiuntivi vengono rimossi. A seconda della DiskSpaceExhaustedBehavior proprietà , viene generata un'eccezione.

  • Il nome file esistente non è aggiornato in base alla pianificazione di creazione del log specificata dalla LogFileCreationSchedule proprietà . Viene creato un nuovo file di log. Il timbro della data viene incorporato nel FullLogFileName nome.

Si applica a

Vedi anche