StreamWriter.AutoFlush Właściwość

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Źródło:

StreamWriter.cs

Pobiera lub ustawia wartość wskazującą, czy StreamWriter bufor zostanie opróżniany do bazowego strumienia po każdym wywołaniu metody 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

Wartość właściwości

Boolean

true aby wymusić StreamWriter opróżnienie buforu; w przeciwnym razie false.

Przykłady

W poniższym przykładzie pokazano składnię AutoFlush użycia właściwości .

// 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

Uwagi

Opróżnienie strumienia nie spowoduje opróżnienia podstawowego kodera, chyba że jawnie wywołasz Flush metodę lub Close. Ustawienie AutoFlush oznacza true , że dane zostaną opróżnione z buforu do strumienia po każdej operacji zapisu, ale stan kodera nie zostanie opróżniony. Dzięki temu koder może zachować stan (częściowe znaki), dzięki czemu będzie mógł poprawnie zakodować następny blok znaków. Ten scenariusz ma wpływ na UTF8 i UTF7, gdzie niektóre znaki mogą być kodowane tylko po otrzymaniu sąsiadującego znaku lub znaków przez koder.

Jeśli AutoFlush parametr ma wartość false, StreamWriter program wykona ograniczoną ilość buforowania, zarówno wewnętrznie, jak i potencjalnie w koderze z przekazanego kodowania. Możesz uzyskać lepszą wydajność, ustawiając wartość AutoFlushfalse, przy założeniu, że zawsze wywołujesz Close metodę (lub co najmniej Flush), gdy skończysz pisać przy użyciu elementu StreamWriter.

Można na przykład ustawić wartość na AutoFlushtrue wartość podczas pisania na urządzeniu, na którym użytkownik oczekuje natychmiastowej opinii. Console.Out jest jednym z następujących przypadków: StreamWriter używany wewnętrznie do zapisu do Console opróżniania całego stanu wewnętrznego z wyjątkiem stanu kodera po każdym wywołaniu metody StreamWriter.Write.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

• We/wy plików i Stream
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku