TraceLogRetentionOption Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает структуру файла, которая будет использоваться для журнала 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 с помощью настраиваемых maximumFileSize атрибутов и maximumNumberOfFiles в файле конфигурации или с помощью maximumFileSize параметров или maximumNumberOfFiles в конструктореEventSchemaTraceListener.MaximumNumberOfFiles maximumFileSize Если атрибуты или maximumNumberOfFiles в файле конфигурации указывают значение вне диапазона, свойствам присваиваются значения по умолчанию. При указании значения вне диапазона в параметре maximumFileSize или maximumNumberOfFiles при вызове конструктора EventSchemaTraceListenerArgumentOutOfRangeException возникает исключение .
В следующей таблице показаны возможные и значения по умолчанию для размера и количества файлов, связанных с каждым параметром хранения журнала трассировки. "Н/Д" указывает, что связанное свойство не проверяется на наличие этого TraceLogRetentionOption значения.
| TraceLogRetentionOption | Максимальный размер файла | Размер файла по умолчанию | Максимальное число файлов | Число файлов по умолчанию |
|---|---|---|---|---|
| LimitedCircularFiles | Н/Д | -1 | Н/Д | 1 |
| LimitedSequentialFiles | >0 | 4 КБ | Н/Д | 1 |
| SingleFileBoundedSize | >0 | 4 КБ | Н/Д | -1 |
| SingleFileUnboundedSize | >0 | 4 КБ | >0 | 1 |
| UnlimitedSequentialFiles | >0 | 4 КБ | >1 | 2 |
