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枚举用于指定 类中 EventSchemaTraceListener 属性的值TraceLogRetentionOption。 该属性设置确定 和 EventSchemaTraceListener.MaximumNumberOfFiles 属性的可能和EventSchemaTraceListener.MaximumFileSize默认值。
可以通过配置文件maximumFileSize中的 MaximumNumberOfFilesmaximumFileSizeMaximumFileSize 和 maximumNumberOfFiles 自定义属性或使用 构造函数中的 EventSchemaTraceListener 或 参数来设置 和 maximumNumberOfFiles 属性。 maximumFileSize如果配置文件中的 或 maximumNumberOfFiles 属性指定了范围外的值，则属性将设置为其默认值。 如果在调用EventSchemaTraceListener构造函数时在 maximumFileSize 或 maximumNumberOfFiles 参数中指定了范围外的值，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 |
