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 určující, zda StreamWriter bude vyprázdnit svou vyrovnávací paměť 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
truevynutit 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
Poznámky
Vyprázdnění datového proudu nevyprázdní jeho podkladový kodér, pokud explicitně nezavoláte Flush nebo Close. Nastavení AutoFlush znamená true , ž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í. Kodér tak může 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 se určité znaky dají zakódovat až po přijetí sousedního znaku nebo znaků kodérem.
Pokud AutoFlush je nastavená hodnota false, StreamWriter provede omezené množství ukládání do vyrovnávací paměti, a to interně i potenciálně v kodéru z kódování, které jste předali. Lepší výkon můžete dosáhnout nastavením AutoFlushfalsena , za předpokladu, že vždy zavoláte Close (nebo alespoň Flush) až budete hotovi s psaním StreamWriter.
Můžete například nastavit AutoFlush , když true píšete do zařízení, kde uživatel očekává okamžitou zpětnou vazbu.
Console.Out je jedním z těchto případů: Používá se StreamWriter interně pro zápis, který Console vyprázdní veškerý jeho vnitřní 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.
