FileLogTraceListener.Append 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
确定是将输出追加到当前文件还是将输出写入新文件或现有文件。
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
,True
指示将输出追加到当前文件,False
指示将输出写入新文件。 此属性的默认设置为 True
。
注解
Append当 属性为 True
时,将在模式下打开Append日志文件,以保留现有日志。 当前写入位置从文件末尾开始,因此任何新日志都追加到文件末尾。
Append
当 属性为 False
时,将在模式下打开Truncate日志文件,其中打开日志文件时会删除所有日志数据。 在FileLogTraceListener
将属性设置为 False
或打开该文件后Append
,在写入第一个日志之前,删除日志文件的现有内容一次。 之后, FileLogTraceListener
将其他跟踪数据追加到文件末尾。 FileLogTraceListener
如果在 Append 设置为 False 时关闭并重新打开实例,则会在写入其他日志之前擦除日志文件数据。 这可能会导致缺少数据,尤其是在配置文件中将 属性的值 Append
设置为 False
时。
此行为在以下方案中被重写:
输出文件被另一个进程锁定。 创建一个新的日志文件,其中包含合并到名称中的 FullLogFileName 版本号。
当前文件大小大于 MaxFileSize 属性允许的大小。 放弃其他消息。 根据 DiskSpaceExhaustedBehavior 属性,会引发异常。
根据 属性指定的 LogFileCreationSchedule 日志创建计划,现有文件名已过期。 将创建一个新的日志文件。 日期戳合并到名称中 FullLogFileName 。