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.MaximumNumberOfFiles 屬性的可能和預設值 EventSchemaTraceListener.MaximumFileSize

您可以透過 maximumFileSize 組態檔中的 和 自訂屬性,或在建構函式中使用 maximumFileSizemaximumNumberOfFiles 參數 EventSchemaTraceListener 來設定 MaximumFileSizeMaximumNumberOfFilesmaximumNumberOfFiles 屬性。 maximumFileSize如果組態檔中的 或 maximumNumberOfFiles 屬性指定超出範圍的值,則屬性會設定為其預設值。 如果您在呼叫 EventSchemaTraceListener 建構函式時,于 或 maximumNumberOfFiles 參數中 maximumFileSize 指定超出範圍的值, ArgumentOutOfRangeException 則會擲回 。

下表顯示與每個追蹤記錄保留選項相關聯之檔案大小和檔案計數的可能和預設值。 「N/A」 表示未檢查該值 TraceLogRetentionOption 的相關屬性。

TraceLogRetentionOption 檔案大小上限 預設檔案大小 檔案數目上限 預設檔案數目
LimitedCircularFiles N/A -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

適用於