TraceLogRetentionOption Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает структуру файлов, которая будет использоваться для журнала EventSchemaTraceListener.
public enum class TraceLogRetentionOption
public enum TraceLogRetentionOption
type TraceLogRetentionOption =
Public Enum TraceLogRetentionOption
- Наследование
Поля
| Имя | Значение | Описание |
|---|---|---|
| UnlimitedSequentialFiles | 0 | Неограниченное количество последовательных файлов, каждый из которых имеет максимальный размер файла, определенный свойством MaximumFileSize . Логическая привязка к количеству или размеру файлов отсутствует, но она ограничена физическими ограничениями, введенными компьютером. |
| LimitedCircularFiles | 1 | Конечное число последовательных файлов, каждое из которых имеет максимальный размер файла. MaximumFileSize После достижения значения свойства запись начинается в новом файле с добавочным целым суффиксом. MaximumNumberOfFiles По достижении значения свойства первый файл очищается и перезаписывается. Затем файлы постепенно перезаписываются циклически. |
| SingleFileUnboundedSize | 2 | Один файл без ограничения максимального размера файла. |
| LimitedSequentialFiles | 3 | Конечное число последовательных файлов, каждое из которых имеет максимальный размер файла. MaximumFileSize После достижения значения свойства запись начинается в новом файле с добавочным целым суффиксом. |
| SingleFileBoundedSize | 4 | Один файл с максимальным размером файла, определяемым свойством MaximumFileSize . |
Комментарии
Перечисление TraceLogRetentionOption используется для указания значения TraceLogRetentionOption свойства в EventSchemaTraceListener классе. Этот параметр свойства определяет возможные значения и значения по умолчанию для EventSchemaTraceListener.MaximumFileSize свойств и EventSchemaTraceListener.MaximumNumberOfFiles свойств.
Вы можете задать MaximumFileSize свойства с помощью maximumFileSize и maximumNumberOfFiles пользовательских атрибутов в файле конфигурации или с помощью maximumFileSizemaximumNumberOfFiles параметров конструктора EventSchemaTraceListenerMaximumNumberOfFiles.
maximumFileSize
maximumNumberOfFiles Если атрибуты в файле конфигурации указывают значение вне диапазона, свойства задаются в значениях по умолчанию. Если при вызове EventSchemaTraceListener конструктора ArgumentOutOfRangeException указать значение maximumFileSize вне диапазона, maximumNumberOfFiles создается исключение.
В следующей таблице показаны возможные значения и значения по умолчанию для размера файла и количества файлов, связанных с каждым параметром хранения журнала трассировки. "N/A" указывает, что связанное свойство не проверяется для этого TraceLogRetentionOption значения.
| TraceLogRetentionOption | Максимальный размер файла | Размер файла по умолчанию | Максимальное число файлов | Количество файлов по умолчанию |
|---|---|---|---|---|
| LimitedCircularFiles | N/A | -1 | N/A | 1 |
| LimitedSequentialFiles | >0 | 4 кб | N/A | 1 |
| SingleFileBoundedSize | >0 | 4 кб | N/A | -1 |
| SingleFileUnboundedSize | >0 | 4 кб | >0 | 1 |
| UnlimitedSequentialFiles | >0 | 4 кб | >1 | 2 |