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日志文件，其中打开日志文件时会删除所有日志数据。 在FileLogTraceListener将属性设置为 False 或打开该文件后Append，在写入第一个日志之前，删除日志文件的现有内容一次。 之后， FileLogTraceListener 将其他跟踪数据追加到文件末尾。 FileLogTraceListener如果在 Append 设置为 False 时关闭并重新打开实例，则会在写入其他日志之前擦除日志文件数据。 这可能会导致缺少数据，尤其是在配置文件中将 属性的值 Append 设置为 False 时。

此行为在以下方案中被重写：

• 输出文件被另一个进程锁定。 创建一个新的日志文件，其中包含合并到名称中的 FullLogFileName 版本号。

• 当前文件大小大于 MaxFileSize 属性允许的大小。 放弃其他消息。 根据 DiskSpaceExhaustedBehavior 属性，会引发异常。

• 根据 属性指定的 LogFileCreationSchedule 日志创建计划，现有文件名已过期。 将创建一个新的日志文件。 日期戳合并到名称中 FullLogFileName 。

另请参阅

• MaxFileSize
• LogFileCreationSchedule