StreamWriter.AutoFlush-Eigenschaft
Ruft einen Wert ab, der angibt, ob der StreamWriter nach jedem Aufruf von StreamWriter.Write den Puffer in den zugrunde liegenden Stream wegschreibt, oder legt diesen fest.
Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Overridable Property AutoFlush As Boolean
'Usage
Dim instance As StreamWriter
Dim value As Boolean
value = instance.AutoFlush
instance.AutoFlush = value
public virtual bool AutoFlush { get; set; }
public:
virtual property bool AutoFlush {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_AutoFlush ()
/** @property */
public void set_AutoFlush (boolean value)
public function get AutoFlush () : boolean
public function set AutoFlush (value : boolean)
Eigenschaftenwert
true, um StreamWriter zum Entleeren des Puffers zu zwingen, andernfalls false.
Hinweise
Durch Entleeren des Streams wird der zugrunde liegende Encoder nicht entleert, wenn Sie nicht ausdrücklich Flush oder Close aufrufen. Wenn AutoFlush auf true festgelegt ist, werden Daten aus dem Puffer in den Stream weggeschrieben, aber der Encoderzustand wird nicht entleert. Dadurch kann der Encoder seinen Zustand beibehalten (Teilzeichen), um den nächsten Block von Zeichen richtig zu codieren. Dieses Szenario betrifft UTF8 und UTF7, bei denen bestimmte Zeichen nur verschlüsselt werden können, nachdem der Encoder das bzw. die angrenzenden Zeichen empfangen hat.
Wenn AutoFlush auf false festgelegt wird, führt StreamWriter intern und möglicherweise auch im bereitgestellten Encoder eine begrenzte Pufferung durch. Sie können die Leistung u. U. verbessern, indem Sie AutoFlush auf false festlegen, vorausgesetzt, Sie rufen nach jedem Schreibvorgang von StreamWriterClose (oder zumindest Flush) auf.
Legen Sie beispielsweise AutoFlush auf true fest, wenn Sie auf ein Gerät schreiben, von dem der Benutzer eine direkte Rückmeldung erwartet. Zu diesen Fällen zählt Console.Out: Der intern für Schreibvorgänge auf Console verwendete StreamWriter schreibt den internen Zustand mit Ausnahme des Encoderzustands nach jedem Aufruf von StreamWriter.Write weg.
Ein Beispiel für die Verwendung dieser Eigenschaft finden Sie im Beispielabschnitt weiter unten. In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.
Aufgabe |
Beispiel in diesem Thema |
|---|---|
Eine Textdatei erstellen. |
|
In eine Textdatei schreiben. |
|
Aus einer Textdatei lesen. |
Beispiel
Das folgende Beispiel veranschaulicht 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;
// 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.set_AutoFlush(true);
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
StreamWriter-Klasse
StreamWriter-Member
System.IO-Namespace
Weitere Ressourcen
Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei