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 свойства в EventSchemaTraceListener классе. TraceLogRetentionOptionThe 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 Свойства и maximumFileSize maximumNumberOfFiles maximumFileSize maximumNumberOfFiles можно задать с помощью настраиваемых атрибутов и в файле конфигурации или с помощью параметров или в EventSchemaTraceListener конструкторе. MaximumNumberOfFilesYou 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. Если атрибуты maximumNumberOfFiles или в файле конфигурации указывают значение вне допустимого диапазона, для свойств задаются значения по умолчанию. maximumFileSizeIf the maximumFileSize or maximumNumberOfFiles attributes in the configuration file specify an out-of-range value, the properties are set to their default values. Если maximumFileSize указать значение вне допустимого диапазона в EventSchemaTraceListener параметре или maximumNumberOfFiles при 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.

трацелогретентионоптионTraceLogRetentionOption Максимальный размер файлаMaximum file size Размер файла по умолчаниюDefault file size Максимальное число файловMaximum number of files Число файлов по умолчаниюDefault number of files
лимитедЦиркуларфилесLimitedCircularFiles Н/ДN/A -1-1 Н/ДN/A 11
лимитедсекуентиалфилесLimitedSequentialFiles >0>0 4 КБ4 kB Н/ДN/A 11
синглефилебаундедсизеSingleFileBoundedSize >0>0 4 КБ4 kB Н/ДN/A -1-1
синглефилеунбаундедсизеSingleFileUnboundedSize >0>0 4 КБ4 kB >0>0 11
унлимитедсекуентиалфилесUnlimitedSequentialFiles >0>0 4 КБ4 kB >1>1 22

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