TraceLogRetentionOption Перечисление

Определение

Задает структуру файла, которая будет использоваться для журнала EventSchemaTraceListener.

public enum class TraceLogRetentionOption
public enum TraceLogRetentionOption
type TraceLogRetentionOption = 
Public Enum TraceLogRetentionOption
Наследование
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

Применяется к