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 プロパティで決定される 1 つのファイル。

SingleFileUnboundedSize 2

最大ファイル サイズの制限がない 1 つのファイル。

UnlimitedSequentialFiles 0

それぞれが MaximumFileSize プロパティで決定される最大ファイル サイズを持つ、数に制限のないシーケンシャル ファイル。 ファイルの数やサイズに論理的な境界はありませんが、コンピューターの物理的な制約に制限されます。

注釈

TraceLogRetentionOption列挙は、 クラスの プロパティの値をTraceLogRetentionOption指定するために使用されますEventSchemaTraceListener。 このプロパティ設定によって、 プロパティと プロパティの使用可能な既定値とEventSchemaTraceListener.MaximumNumberOfFiles既定値がEventSchemaTraceListener.MaximumFileSize決まります。

プロパティと MaximumNumberOfFiles プロパティはMaximumFileSize、構成ファイルの maximumFileSize および maximumNumberOfFiles カスタム属性を使用するか、コンストラクターの または maximumNumberOfFiles パラメーターをEventSchemaTraceListener使用maximumFileSizeして設定できます。 maximumFileSize構成ファイルの 属性または maximumNumberOfFiles 属性が範囲外の値を指定した場合、プロパティは既定値に設定されます。 コンストラクターを呼び出すときに または パラメーターにmaximumFileSize範囲外の値をEventSchemaTraceListener指定すると、 ArgumentOutOfRangeException がスローmaximumNumberOfFilesされます。

次の表は、各トレース ログ保持オプションに関連付けられているファイル サイズとファイル数の可能な既定値と既定値を示しています。 "N/A" は、関連付けられているプロパティがその値に対してチェックされていないことを TraceLogRetentionOption 示します。

TraceLogRetentionOption ファイルの最大サイズ 既定のファイル サイズ ファイルの最大数 ファイルの既定の数
LimitedCircularFiles 該当なし -1 N/A 1
LimitedSequentialFiles >0 4 kB N/A 1
SingleFileBoundedSize >0 4 kB N/A -1
SingleFileUnboundedSize >0 4 kB >0 1
UnlimitedSequentialFiles >0 4 kB >1 2

適用対象