StreamWriter.AutoFlush Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der StreamWriter Puffer nach jedem Aufruf Write(Char)zum zugrunde liegenden Datenstrom geleert wird.
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 BooleanEigenschaftswert
true um das Leeren des Puffers zu erzwingen StreamWriter ; andernfalls false.
Beispiele
Das folgende Beispiel zeigt die Syntax für die Verwendung der AutoFlush Eigenschaft.
// 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
Hinweise
Durch das Leeren des Datenstroms wird der zugrunde liegende Encoder nicht geleert, es sei denn, Sie rufen Flush explizit auf oder Close. Die Einstellung AutoFlush bedeutet true , dass Daten nach jedem Schreibvorgang aus dem Puffer in den Datenstrom geleert werden, der Encoderstatus wird jedoch nicht geleert. Dadurch kann der Encoder seinen Zustand (Teilzeichen) beibehalten, damit er den nächsten Zeichenblock richtig codieren kann. Dieses Szenario wirkt sich auf UTF8 und UTF7 aus, bei dem bestimmte Zeichen nur codiert werden können, nachdem der Encoder das angrenzende Zeichen oder zeichen empfängt.
Wenn AutoFlush dieser Wert auf false festgelegt ist, StreamWriter erfolgt eine begrenzte Puffermenge, sowohl intern als auch potenziell im Encoder aus der von Ihnen übergebenen Codierung. Sie können eine bessere Leistung erzielen, indem Sie festlegen AutoFlushfalse, dass Sie immer (oder zumindestFlush) anrufen Close , wenn Sie mit einem StreamWriterSchreiben fertig sind.
Legen AutoFlush Sie beispielsweise fest true , wann Sie auf ein Gerät schreiben, auf dem der Benutzer sofortiges Feedback erwartet.
Console.Out ist einer der folgenden Fälle: Der StreamWriter intern zum Schreiben zum Leeren Console des gesamten internen Zustands verwendet wird, mit Ausnahme des Encoderzustands nach jedem Aufruf von StreamWriter.Write.
Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".