FileLogTraceListener.Append Properti

Definisi

Menentukan apakah akan menambahkan output ke file saat ini atau menulisnya ke file baru atau yang sudah ada.

public bool Append { get; set; }

Nilai Properti

Boolean, dengan True menunjukkan bahwa output ditambahkan ke file saat ini, dan False menunjukkan bahwa output ditulis ke file baru. Pengaturan default untuk properti ini adalah True.

Keterangan

Append Ketika properti adalah True, file log dibuka dalam Append mode , untuk menyimpan log yang ada. Posisi penulisan saat ini dimulai di akhir file, sehingga setiap log baru ditambahkan ke akhir file.

Append Ketika properti adalah False, file log dibuka dalam mode , di Truncate mana semua data log dihapus saat file log dibuka. Menghapus FileLogTraceListener konten file log yang ada sekali setelah Append propery diatur ke False atau file dibuka dan sebelum menulis log pertama. Setelah itu, FileLogTraceListener tambahkan data pelacakan tambahan ke akhir file. FileLogTraceListener Jika instans ditutup dan kemudian dibuka kembali saat Tambahkan diatur ke False, instans akan menghapus data file log sebelum menulis log tambahan. Ini dapat menyebabkan data yang hilang, terutama jika Anda mengatur nilai Append properti ke False dalam file konfigurasi.

Perilaku ini ditimpa dalam skenario berikut:

  • File output dikunci oleh proses lain. File log baru dibuat dengan nomor versi yang dimasukkan ke FullLogFileName dalam nama.

  • Ukuran file saat ini lebih besar dari yang MaxFileSize diizinkan properti. Pesan tambahan dibuang. Tergantung pada DiskSpaceExhaustedBehavior properti , pengecualian dilemparkan.

  • Nama file yang ada sudah kedaluarsa sesuai dengan jadwal pembuatan log yang ditentukan oleh LogFileCreationSchedule properti . File log baru dibuat. Stempel tanggal dimasukkan ke FullLogFileName dalam nama.

Berlaku untuk

Lihat juga