StreamWriter.AutoFlush Properti
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.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah StreamWriter akan menghapus buffernya ke aliran yang mendasar setelah setiap panggilan ke Write(Char).
public:
virtual property bool AutoFlush { bool get(); void set(bool value); };public virtual bool AutoFlush { get; set; }member this.AutoFlush : bool with get, setPublic Overridable Property AutoFlush As BooleanNilai Properti
true untuk memaksa StreamWriter untuk membersihkan buffernya; jika tidak, false.
Contoh
Contoh berikut menunjukkan sintaks untuk menggunakan AutoFlush properti .
// Gets or sets a value indicating whether the StreamWriter
// will flush its buffer to the underlying stream after every
// call to StreamWriter.Write.
sw->AutoFlush = true;
// Gets or sets a value indicating whether the StreamWriter
// will flush its buffer to the underlying stream after every
// call to StreamWriter.Write.
sw.AutoFlush = true;
' Gets or sets a value indicating whether the StreamWriter
' will flush its buffer to the underlying stream after every
' call to StreamWriter.Write.
Sw.AutoFlush = True
Keterangan
Menghapus aliran tidak akan menghapus encoder yang mendasar kecuali Anda secara eksplisit memanggil Flush atau Close. Pengaturan AutoFlush ke true berarti bahwa data akan dihapus dari buffer ke aliran setelah setiap operasi tulis, tetapi status encoder tidak akan dibersihkan. Ini memungkinkan encoder untuk mempertahankan statusnya (karakter parsial) sehingga dapat mengodekan blok karakter berikutnya dengan benar. Skenario ini memengaruhi UTF8 dan UTF7 di mana karakter tertentu hanya dapat dikodekan setelah encoder menerima karakter atau karakter yang berdekatan.
Ketika AutoFlush diatur ke false, StreamWriter akan melakukan buffering dalam jumlah terbatas, baik secara internal maupun berpotensi dalam encoder dari pengodean yang Anda lewati. Anda bisa mendapatkan performa yang lebih baik dengan mengatur AutoFlush ke , dengan asumsi bahwa Anda selalu memanggil Close (atau setidaknya Flush) ketika Anda selesai menulis dengan StreamWriterfalse.
Misalnya, atur AutoFlush ke true saat Anda menulis ke perangkat di mana pengguna mengharapkan umpan balik segera. Console.Out adalah salah satu kasus ini: yang StreamWriter digunakan secara internal untuk menulis untuk Console membersihkan semua status internalnya kecuali status encoder setelah setiap panggilan ke StreamWriter.Write.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
