StreamWriter.AutoFlush Properti

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Sumber:

StreamWriter.cs

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, set

Public Overridable Property AutoFlush As Boolean

Nilai Properti

Boolean

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.

Lihat juga

• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File