FileLogTraceListener.Append Eigenschaft

Definition

Namespace:

Microsoft.VisualBasic.Logging

Assembly:

Microsoft.VisualBasic.Forms.dll

Bestimmt, ob die Ausgabe an die aktuelle Datei angefügt oder in eine neue oder vorhandene Datei geschrieben werden soll.

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

Eigenschaftswert

Boolean

Ein Boolean-Wert, wobei True angibt, dass die Ausgabe an die aktuelle Datei angefügt wird, wohingegen die Ausgabe bei False in eine neue Datei geschrieben wird. Die Standardeinstellung für diese Eigenschaft ist True.

Hinweise

Wenn die Append -Eigenschaft ist True, wird die Protokolldatei im Append Modus geöffnet, um vorhandene Protokolle beizubehalten. Die aktuelle Schreibposition beginnt am Ende der Datei, sodass alle neuen Protokolle am Ende der Datei angefügt werden.

Wenn die Append -Eigenschaft ist False, wird die Protokolldatei im Truncate Modus geöffnet, in dem alle Protokolldaten gelöscht werden, wenn die Protokolldatei geöffnet wird. Der FileLogTraceListener löscht vorhandene Inhalte der Protokolldatei einmal, nachdem die Append -Eigenschaft auf False festgelegt wurde oder die Datei geöffnet wird und bevor das erste Protokoll geschrieben wird. Danach FileLogTraceListener fügt zusätzliche Ablaufverfolgungsdaten am Ende der Datei an. Wenn die FileLogTraceListener instance geschlossen und dann erneut geöffnet wird, während Anfügen auf False festgelegt ist, werden die Protokolldateidaten vor dem Schreiben zusätzlicher Protokolle gelöscht. Dies kann zu fehlenden Daten führen, insbesondere wenn Sie den Wert der Append Eigenschaft in einer Konfigurationsdatei auf False festlegen.

Dieses Verhalten wird in den folgenden Szenarien überschrieben:

• Die Ausgabedatei wird durch einen anderen Prozess gesperrt. Eine neue Protokolldatei wird mit einer Versionsnummer erstellt, die in den FullLogFileName Namen integriert ist.

• Die aktuelle Dateigröße ist größer als die von der MaxFileSize -Eigenschaft zulässige. Zusätzliche Nachrichten werden verworfen. Abhängig von der DiskSpaceExhaustedBehavior -Eigenschaft wird eine Ausnahme ausgelöst.

• Der vorhandene Dateiname ist gemäß dem von der -Eigenschaft angegebenen LogFileCreationSchedule Protokollerstellungszeitplan veraltet. Eine neue Protokolldatei wird erstellt. Der Datumsstempel wird in den FullLogFileName Namen eingefügt.

Weitere Informationen

• MaxFileSize
• LogFileCreationSchedule