TraceLogRetentionOption Enum
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menentukan struktur file yang akan digunakan untuk log EventSchemaTraceListener.
public enum class TraceLogRetentionOption
public enum TraceLogRetentionOption
type TraceLogRetentionOption =
Public Enum TraceLogRetentionOption
- Warisan
Bidang
| Nama | Nilai | Deskripsi |
|---|---|---|
| UnlimitedSequentialFiles | 0 | Jumlah file berurutan yang tidak terbatas, masing-masing dengan ukuran file maksimum yang ditentukan oleh MaximumFileSize properti . Tidak ada batasan logis ke jumlah atau ukuran file, tetapi dibatasi oleh batasan fisik yang diberlakukan oleh komputer. |
| LimitedCircularFiles | 1 | Jumlah file berurutan terbatas, masing-masing dengan ukuran file maksimum. MaximumFileSize Ketika nilai properti tercapai, penulisan dimulai dalam file baru dengan akhiran bilangan bulat bertahap. MaximumNumberOfFiles Ketika nilai properti tercapai, file pertama dihapus dan ditimpa. File kemudian ditimpa secara bertahap secara melingkar. |
| SingleFileUnboundedSize | 2 | Satu file tanpa batasan ukuran file maksimum. |
| LimitedSequentialFiles | 3 | Jumlah file berurutan terbatas, masing-masing dengan ukuran file maksimum. MaximumFileSize Ketika nilai properti tercapai, penulisan dimulai dalam file baru dengan akhiran bilangan bulat bertahap. |
| SingleFileBoundedSize | 4 | Satu file dengan ukuran file maksimum yang ditentukan oleh MaximumFileSize properti . |
Keterangan
Enumerasi TraceLogRetentionOption digunakan untuk menentukan nilai TraceLogRetentionOption properti di EventSchemaTraceListener kelas . Pengaturan properti tersebut menentukan nilai yang mungkin dan default untuk EventSchemaTraceListener.MaximumFileSize properti dan EventSchemaTraceListener.MaximumNumberOfFiles .
Anda dapat mengatur MaximumFileSize properti dan MaximumNumberOfFiles melalui maximumFileSize atribut kustom dan maximumNumberOfFiles dalam file konfigurasi atau dengan menggunakan maximumFileSize parameter atau maximumNumberOfFiles di EventSchemaTraceListener konstruktor.
maximumFileSize Jika atribut atau maximumNumberOfFiles dalam file konfigurasi menentukan nilai di luar rentang, properti diatur ke nilai defaultnya. Jika Anda menentukan nilai di luar rentang dalam maximumFileSize parameter atau maximumNumberOfFiles saat Anda memanggil EventSchemaTraceListener konstruktor, maka ArgumentOutOfRangeException akan dilemparkan.
Tabel berikut ini memperlihatkan nilai yang mungkin dan default untuk ukuran file dan jumlah file yang terkait dengan setiap opsi retensi log jejak. "N/A" menunjukkan bahwa properti terkait tidak diperiksa untuk nilai tersebut TraceLogRetentionOption .
| TraceLogRetentionOption | Ukuran file maksimal | Ukuran file default | Jumlah maksimum berkas | Jumlah file default |
|---|---|---|---|---|
| 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 |