StreamWriter.AutoFlush Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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, setPublic Overridable Property AutoFlush As BooleanHodnota vlastnosti
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.
