FileLogTraceListener.Append 屬性

定義

命名空間:

Microsoft.VisualBasic.Logging

組件:

Microsoft.VisualBasic.Forms.dll

判斷要將輸出附加至目前的檔案，或將它寫入新檔案或現有的檔案。

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

屬性值

Boolean

Boolean，如果為 True 表示會將輸出附加至目前的檔案，如果為 False 則表示會將輸出寫入新檔案。 這個屬性的預設設定為 True。

備註

Append當 屬性為 True時，會以 Append 模式開啟記錄檔，以保留現有的記錄檔。 目前的寫入位置會從檔案結尾開始，以便將任何新的記錄附加至檔案的結尾。

Append當屬性為 False時，會在模式中Truncate開啟記錄檔，其中開啟記錄檔時會刪除所有記錄數據。 在正確設定為 False 或開啟檔案之後Append，以及寫入第一個記錄檔之前，刪除FileLogTraceListener記錄檔的現有內容一次。 之後， FileLogTraceListener 將其他追蹤數據附加至檔案結尾。 FileLogTraceListener如果實例已關閉，然後在 Append 設定為 False 時重新開啟，則會在寫入其他記錄之前清除記錄檔數據。 這可能會導致遺失數據，特別是當您在組態檔中將 屬性的值 Append 設定為 False 時。

在下列案例中會覆寫此行為：

• 輸出檔案被另一個進程鎖定。 系統會使用併入 FullLogFileName 名稱的版本號碼來建立新的記錄檔。

• 目前的檔案大小大於 屬性允許的大小 MaxFileSize 。 會捨棄其他訊息。 根據 DiskSpaceExhaustedBehavior 屬性，會擲回例外狀況。

• 根據屬性所 LogFileCreationSchedule 指定的記錄建立排程，現有的檔名已過期。 系統會建立新的記錄檔。 日期戳記會併入名稱中 FullLogFileName 。

另請參閱

• MaxFileSize
• LogFileCreationSchedule