StreamWriter.AutoFlush Vlastnost

  • Reference

Definice

Obor názvů:
System.IO
Sestavení:
System.IO.dll
Sestavení:
System.Runtime.dll
Sestavení:
netstandard.dll
Sestavení:
System.Runtime.Extensions.dll
Sestavení:
mscorlib.dll

Získá nebo nastaví hodnotu určující, zda bude vyprázdnit svou vyrovnávací paměť do StreamWriter 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

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

Pokud je hodnota nastavená na , použije se omezené množství ukládání do vyrovnávací paměti, a to interně i potenciálně v kodéru z kódování, AutoFlush false které jste StreamWriter předal. Pokud nastavíte na , můžete získat lepší výkon za předpokladu, že po napsání s budete vždy volat (nebo alespoň AutoFlush false ) Close Flush StreamWriter .

Například při zápisu na zařízení, kde uživatel očekává okamžitou zpětnou AutoFlush true vazbu, nastavte na . Console.Outje jedním z těchto případů: Objekt slouží interně k zápisu, který po každém volání vyprázdní veškerý vnitřní stav s výjimkou stavu StreamWriter Console kodéru. StreamWriter.Write

Seznam běžných V/V úloh najdete v tématu Běžné V/V úlohy.

Platí pro

Viz také