FileLogTraceListener.Append 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
判斷要將輸出附加至目前的檔案，或將它寫入新檔案或現有的檔案。
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 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 。
