TraceLogRetentionOption 列舉
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
指定用於 EventSchemaTraceListener 記錄的檔案結構。
public enum class TraceLogRetentionOptionpublic enum TraceLogRetentionOptiontype TraceLogRetentionOption = Public Enum TraceLogRetentionOption- 繼承
欄位
| LimitedCircularFiles | 1 | 有限數目的循序檔案，各有其檔案大小上限。 當達到 MaximumFileSize 屬性值的時候，就會開始寫入新檔案，加上遞增的整數字尾。 當達到 MaximumNumberOfFiles 屬性值的時候，就會清除並覆寫第一個檔案。 然後，檔案會採用循環方式遞增覆寫。 |
| LimitedSequentialFiles | 3 | 有限數目的循序檔案，各有其檔案大小上限。 當達到 MaximumFileSize 屬性值的時候，就會開始寫入新檔案，加上遞增的整數字尾。 |
| SingleFileBoundedSize | 4 | 一個檔案，其檔案大小上限由 MaximumFileSize 屬性決定。 |
| SingleFileUnboundedSize | 2 | 一個沒有檔案大小限制的檔案。 |
| UnlimitedSequentialFiles | 0 | 不限數目的循序檔案，各有其檔案大小上限，由 MaximumFileSize 屬性決定。 檔案的數目或大小並沒有邏輯上的限制，但會受到電腦的實體條件所限制。 |
備註
列舉 TraceLogRetentionOption 是用來指定 TraceLogRetentionOption 類別中的 EventSchemaTraceListener 屬性值。 該屬性設定會決定 和 EventSchemaTraceListener.MaximumNumberOfFiles 屬性的可能和預設值EventSchemaTraceListener.MaximumFileSize。
您可以透過 maximumFileSize 組態檔中的 和 自訂屬性，或在建構函式中使用 maximumFileSize 或 maximumNumberOfFiles 參數EventSchemaTraceListener來設定 MaximumFileSize 和 MaximumNumberOfFilesmaximumNumberOfFiles 屬性。 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 |
