TraceLogRetentionOption 列舉
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
指定將用於 EventSchemaTraceListener 記錄檔的檔案結構。
public enum class TraceLogRetentionOptionpublic enum TraceLogRetentionOptiontype TraceLogRetentionOption = Public Enum TraceLogRetentionOption- 繼承
欄位
| 名稱 | 值 | Description |
|---|---|---|
| UnlimitedSequentialFiles | 0 | 無限數量的連續檔案，每個檔案的最大檔案大小由屬性 MaximumFileSize 決定。 檔案數量或大小沒有邏輯上的限制，但受限於電腦施加的物理限制。 |
| LimitedCircularFiles | 1 | 有限數量的連續檔案，每個檔案有最大檔案大小。 當屬性值達到時 MaximumFileSize ，寫入會從一個帶有遞增整數字尾的新檔案開始。 當 MaximumNumberOfFiles 屬性值達到時，第一個檔案會被清除並覆寫。 檔案會以循環的方式逐步覆寫。 |
| SingleFileUnboundedSize | 2 | 一個沒有最大檔案大小限制的檔案。 |
| LimitedSequentialFiles | 3 | 有限數量的連續檔案，每個檔案有最大檔案大小。 當屬性值達到時 MaximumFileSize ，寫入會從一個帶有遞增整數字尾的新檔案開始。 |
| SingleFileBoundedSize | 4 | 一個檔案，最大檔案大小由屬性 MaximumFileSize 決定。 |
備註
TraceLogRetentionOption列舉用於指定該類別屬性TraceLogRetentionOption的值EventSchemaTraceListener。 該屬性設定決定了 和 EventSchemaTraceListener.MaximumFileSize 屬性的EventSchemaTraceListener.MaximumNumberOfFiles可能值與預設值。
你可以透過MaximumFileSize設定檔中的 and MaximumNumberOfFiles 自訂屬性，或在建構子中使用 maximumFileSize or maximumNumberOfFiles 參數maximumFileSize來設定 maximumNumberOfFiles and EventSchemaTraceListener 屬性。 如果 maximumFileSize 設定檔中的 or maximumNumberOfFiles 屬性指定了超出範圍的值，屬性會被設定為預設值。 如果你在呼叫maximumFileSize建構子時，在 or maximumNumberOfFiles 參數中指定超出範圍的值EventSchemaTraceListener，就會拋出 aArgumentOutOfRangeException。
下表顯示了每個追蹤日誌保留選項所對應的檔案大小與檔案數量的可能與預設值。 「N/A」表示該屬性未被檢查該 TraceLogRetentionOption 值。
| TraceLogRetentionOption | 檔案大小上限 | 預設檔案大小 | 檔案數目上限 | 預設檔案數量 |
|---|---|---|---|---|
| 有限循環檔案 | 無 | -1 | 無 | 1 |
| 有限順序檔案 | >0 | 4 kB | 無 | 1 |
| SingleFileBoundedSize | >0 | 4 kB | 無 | -1 |
| SingleFileUnboundedSize | >0 | 4 kB | >0 | 1 |
| 無限序列檔案 | >0 | 4 kB | >1 | 2 |
