StreamWriter.AutoFlush Vlastnost

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zdroj:

StreamWriter.cs

Získá nebo nastaví hodnotu označující, zda StreamWriter bude vyrovnávací paměť vyprázdnět do podkladového datového proudu po každém volání .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

Hodnota vlastnosti

Boolean

true vynutit StreamWriter vyprázdnění vyrovnávací paměti, jinak false.

Příklady

Následující příklad ukazuje syntaxi pro použití AutoFlush vlastnosti.

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

Poznámky

Vyprázdnění datového proudu nevyprázdní jeho základní kodér, pokud explicitně nevoláte Flush nebo Close. Nastavení AutoFlush na true znamená, že data se po každé operaci zápisu vyprázdní z vyrovnávací paměti do datového proudu, ale stav kodéru se nevyprázdní. To umožňuje kodéru zachovat svůj stav (částečné znaky), aby mohl správně zakódovat další blok znaků. Tento scénář má vliv na UTF8 a UTF7, kde určité znaky lze zakódovat pouze poté, co kodér přijme sousední znak nebo znaky.

Pokud AutoFlush je nastavená na false, StreamWriter provede omezené množství ukládání do vyrovnávací paměti, a to jak interně, tak potenciálně v kodéru z kódování, které jste předali. Lepšího výkonu dosáhnete nastavením AutoFlush na falsehodnotu , a to za předpokladu, že vždy zavoláte Close (nebo alespoň Flush) po dokončení psaní pomocí StreamWriter.

Nastavte AutoFlush například na true při psaní do zařízení, kde uživatel očekává okamžitou zpětnou vazbu. Console.Out je jeden z těchto případů: Interně StreamWriter použitý k zápisu k Console vyprázdnění všech svých vnitřních stavů s výjimkou stavu kodéru po každém volání StreamWriter.Write.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

• Vstupně-výstupní operace souborů a Stream
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru