TraceLogRetentionOption 枚举
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
指定将用于 EventSchemaTraceListener 日志的文件结构。
public enum class TraceLogRetentionOptionpublic enum TraceLogRetentionOptiontype TraceLogRetentionOption = Public Enum TraceLogRetentionOption- 继承
字段
| LimitedCircularFiles | 1 | 数量有限的顺序文件，每个文件均具有最大文件大小。 当达到 MaximumFileSize 属性值时，即开始在带有递增整数后缀的新文件中写入。 当达到 MaximumNumberOfFiles 属性值时，会清除和覆盖第一个文件。 然后，会以循环方式逐渐覆盖这些文件。 |
| LimitedSequentialFiles | 3 | 数量有限的顺序文件，每个文件均具有最大文件大小。 当达到 MaximumFileSize 属性值时，即开始在带有递增整数后缀的新文件中写入。 |
| SingleFileBoundedSize | 4 | 一个最大文件大小由 MaximumFileSize 属性确定的文件。 |
| SingleFileUnboundedSize | 2 | 一个没有最大文件大小限制的文件。 |
| UnlimitedSequentialFiles | 0 | 无限数量的顺序文件，每个文件的最大文件大小由 MaximumFileSize 属性确定。 文件数量或大小没有逻辑上的约束，但受限于计算机强制的物理约束。 |
注解
TraceLogRetentionOption枚举用于指定 TraceLogRetentionOption 类中的属性的值 EventSchemaTraceListener 。 该属性设置将确定和属性的可能值和默认值 EventSchemaTraceListener.MaximumFileSize EventSchemaTraceListener.MaximumNumberOfFiles 。
您可以 MaximumFileSize MaximumNumberOfFiles 通过 maximumFileSize maximumNumberOfFiles 配置文件中的和自定义特性或使用 maximumFileSize maximumNumberOfFiles 构造函数中的或参数来设置和属性 EventSchemaTraceListener 。 如果 maximumFileSize maximumNumberOfFiles 配置文件中的或特性指定了超出范围的值，则属性将设置为其默认值。 如果在 maximumFileSize 调用构造函数时在或参数中指定了超出范围的值 maximumNumberOfFiles ，则 EventSchemaTraceListener ArgumentOutOfRangeException 会引发。
下表显示与每个跟踪日志保留选项关联的文件大小和文件计数的可能和默认值。 “N/A”表示未为该 TraceLogRetentionOption 值检查关联的属性。
| TraceLogRetentionOption | 文件大小上限 | 默认文件大小 | 最大文件数 | 默认文件数 |
|---|---|---|---|---|
| LimitedCircularFiles | 不可用 | -1 | 不可用 | 1 |
| LimitedSequentialFiles | >0 | 4 kB | 不可用 | 1 |
| SingleFileBoundedSize | >0 | 4 kB | 不可用 | -1 |
| SingleFileUnboundedSize | >0 | 4 kB | >0 | 1 |
| UnlimitedSequentialFiles | >0 | 4 kB | >1 | 2 |