TraceLogRetentionOption TraceLogRetentionOption TraceLogRetentionOption TraceLogRetentionOption Enum

Определение

Задает структуру файла, которая будет использоваться для журнала EventSchemaTraceListener.Specifies the file structure that will be used for the EventSchemaTraceListener log.

public enum class TraceLogRetentionOption
public enum TraceLogRetentionOption
type TraceLogRetentionOption = 
Public Enum TraceLogRetentionOption
Наследование
TraceLogRetentionOptionTraceLogRetentionOptionTraceLogRetentionOptionTraceLogRetentionOption

Поля

LimitedCircularFiles LimitedCircularFiles LimitedCircularFiles LimitedCircularFiles 1

Конечное число последовательных файлов, каждый из которых максимального размера.A finite number of sequential files, each with a maximum file size. При достижении значения свойства MaximumFileSize начинается запись нового файла с увеличенным целочисленным суффиксом.When the MaximumFileSize property value is reached, writing starts in a new file with an incremented integer suffix. При достижении значения свойства MaximumNumberOfFiles первый файл очищается и перезаписывается.When the MaximumNumberOfFiles property value is reached, the first file is cleared and overwritten. Затем файлы последовательно циклически перезаписываются.Files are then incrementally overwritten in a circular manner.

LimitedSequentialFiles LimitedSequentialFiles LimitedSequentialFiles LimitedSequentialFiles 3

Конечное число последовательных файлов, каждый из которых максимального размера.A finite number of sequential files, each with a maximum file size. При достижении значения свойства MaximumFileSize начинается запись нового файла с увеличенным целочисленным суффиксом.When the MaximumFileSize property value is reached, writing starts in a new file with an incremented integer suffix.

SingleFileBoundedSize SingleFileBoundedSize SingleFileBoundedSize SingleFileBoundedSize 4

Один файл с максимальным размером, определенным свойством MaximumFileSize.One file with a maximum file size that is determined by the MaximumFileSize property.

SingleFileUnboundedSize SingleFileUnboundedSize SingleFileUnboundedSize SingleFileUnboundedSize 2

Один файл без ограничения максимального размера.One file with no maximum file size restriction.

UnlimitedSequentialFiles UnlimitedSequentialFiles UnlimitedSequentialFiles UnlimitedSequentialFiles 0

Неограниченное число последовательных файлов, каждый из которых с максимальным размером, определенным свойством MaximumFileSize.An unlimited number of sequential files, each with a maximum file size that is determined by the MaximumFileSize property. Не существует логических границ для количества или размера файлов, однако существуют пределы физических ограничений, налагаемых компьютером.There is no logical bound to the number or size of the files, but it is limited by the physical constraints imposed by the computer.

Комментарии

TraceLogRetentionOption Перечисление используется для указания значения TraceLogRetentionOption свойство в EventSchemaTraceListener класса.The TraceLogRetentionOption enumeration is used to specify the value of the TraceLogRetentionOption property in the EventSchemaTraceListener class. Что параметр свойства определяет возможные значения и значение по умолчанию значения для EventSchemaTraceListener.MaximumFileSize и EventSchemaTraceListener.MaximumNumberOfFiles свойства.That property setting determines the possible and default values for the EventSchemaTraceListener.MaximumFileSize and EventSchemaTraceListener.MaximumNumberOfFiles properties.

Можно задать MaximumFileSize и MaximumNumberOfFiles свойств с помощью maximumFileSize и maximumNumberOfFiles настраиваемые атрибуты в файле конфигурации или с помощью maximumFileSize или maximumNumberOfFiles параметров в EventSchemaTraceListener конструктор.You can set the MaximumFileSize and MaximumNumberOfFiles properties through the maximumFileSize and maximumNumberOfFiles custom attributes in the configuration file or by using the maximumFileSize or maximumNumberOfFiles parameters in the EventSchemaTraceListener constructor. Если maximumFileSize или maximumNumberOfFiles атрибуты в файле конфигурации указано значение вне диапазона, свойства устанавливаются значения по умолчанию.If the maximumFileSize or maximumNumberOfFiles attributes in the configuration file specify an out-of-range value, the properties are set to their default values. Если указано значение вне диапазона в maximumFileSize или maximumNumberOfFiles параметра при вызове EventSchemaTraceListener конструктор, ArgumentOutOfRangeException возникает исключение.If you specify an out-of-range value in the maximumFileSize or maximumNumberOfFiles parameter when you call the EventSchemaTraceListener constructor, an ArgumentOutOfRangeException is thrown.

Ниже приведены возможные значения и по умолчанию значения для размера файла и число файлов, которые связаны с каждой параметр хранения журнала трассировки.The following table shows the possible and default values for file size and file count that are associated with each trace log retention option. «Н/д» указывает, что связанного свойства не проверяется на наличие, TraceLogRetentionOption значение."N/A" indicates that the associated property is not checked for that TraceLogRetentionOption value.

TraceLogRetentionOptionTraceLogRetentionOption Максимальный размер файлаMaximum file size Размер файла по умолчаниюDefault file size Максимальное число файловMaximum number of files Число файловDefault number of files
LimitedCircularFilesLimitedCircularFiles Н/ДN/A -1-1 Н/ДN/A 11
LimitedSequentialFilesLimitedSequentialFiles >0>0 4 КБ4 kB Н/ДN/A 11
SingleFileBoundedSizeSingleFileBoundedSize >0>0 4 КБ4 kB Н/ДN/A -1-1
SingleFileUnboundedSizeSingleFileUnboundedSize >0>0 4 КБ4 kB >0>0 11
UnlimitedSequentialFilesUnlimitedSequentialFiles >0>0 4 КБ4 kB >1>1 22

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