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

Определение

Задает структуру файла, которая будет использоваться для журнала 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
Наследование
TraceLogRetentionOption

Поля

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 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 4

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

SingleFileUnboundedSize 2

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

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.

трацелогретентионоптион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

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