FileLogTraceListener.Append 屬性

定義

命名空間:

Microsoft.VisualBasic.Logging

組件:

Microsoft.VisualBasic.Forms.dll

來源:

FileLogTraceListener.vb

決定是否將輸出附加到目前檔案，或寫入新檔案或現有檔案。

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 模式開啟，開啟日誌檔案時所有日誌資料都會被刪除。 它會在FileLogTraceListener專案設定為 或False檔案開啟後，且在寫入第一筆日誌前，刪除日誌檔案Append中既有的內容一次。 之後， FileLogTraceListener 會在檔案末尾附加額外的追蹤資料。 如果 FileLogTraceListener 實例被關閉後再重新開啟，且 Append 設為 False，會先清除日誌檔案資料，再寫入更多日誌。 這可能導致資料遺失，尤其是當你在設定檔中設定屬性值 Append 為 時 False 。

此行為在以下情境下會被覆蓋：

• 輸出檔案被另一個程序鎖定。 會建立一個新的日誌檔，並包含一個版本號，並將版本號納入名稱 FullLogFileName 中。

• 目前的檔案大小超出了該 MaxFileSize 屬性允許的範圍。 額外的訊息會被丟棄。 根據物業 DiskSpaceExhaustedBehavior 不同，會提出例外。

• 根據該 LogFileCreationSchedule 屬性指定的日誌建立時程，現有的檔案名稱已過時。 會建立一個新的日誌檔。 日期戳記已納入名稱中 FullLogFileName 。

另請參閱

• MaxFileSize
• LogFileCreationSchedule