FileLogTraceListener.Append Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property Append As BooleanEigenschaftswert
Boolean, wobei True angegeben wird, dass die Ausgabe an die aktuelle Datei angefügt wird und False angibt, dass die Ausgabe in eine neue Datei geschrieben wird. Die Standardeinstellung für diese Eigenschaft lautet True.
Hinweise
Wenn die Append Eigenschaft lautet 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 lautet False, wird die Protokolldatei im Truncate Modus geöffnet, in dem alle Protokolldaten beim Öffnen der Protokolldatei gelöscht werden. Der FileLogTraceListener vorhandene Inhalt der Protokolldatei wird einmal gelöscht, nachdem die Append Eigenschaft auf die Datei festgelegt False wurde oder die Datei geöffnet wird und bevor das erste Protokoll geschrieben wird. Fügen Sie danach FileLogTraceListener zusätzliche Ablaufverfolgungsdaten an das Ende der Datei an. Wenn die FileLogTraceListener Instanz geschlossen und dann erneut geöffnet wird, während "Append" auf "False" festgelegt ist, werden die Protokolldateidaten gelöscht, bevor zusätzliche Protokolle geschrieben werden. Dies kann zu fehlenden Daten führen, insbesondere, wenn Sie den Wert der Append Eigenschaft False in einer Konfigurationsdatei festlegen.
Dieses Verhalten wird in den folgenden Szenarien außer Kraft gesetzt:
Die Ausgabedatei ist 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 zulässige MaxFileSize Eigenschaft. Weitere Nachrichten werden verworfen. Je DiskSpaceExhaustedBehavior nach Eigenschaft wird eine Ausnahme ausgelöst.
Der vorhandene Dateiname ist gemäß dem durch die Eigenschaft angegebenen Zeitplan für die LogFileCreationSchedule Protokollerstellung veraltet. Es wird eine neue Protokolldatei erstellt. Der Datumsstempel wird in den FullLogFileName Namen integriert.
