StreamWriter.AutoFlush Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de StreamWriter buffer na elke aanroep naar Write(Char)de onderliggende stroom wordt leeggemaakt.
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 BooleanWaarde van eigenschap
true afdwingen StreamWriter om de buffer leeg te maken; falseanders .
Voorbeelden
In het volgende voorbeeld ziet u de syntaxis voor het gebruik van de AutoFlush eigenschap.
// 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
Opmerkingen
Als u de stream leeg maakt, wordt de onderliggende encoder niet leeggemaakt, tenzij u expliciet aanroept Flush of Close. Dit betekent AutoFlushtrue dat gegevens na elke schrijfbewerking van de buffer naar de stroom worden leeggemaakt, maar dat de encoderstatus niet wordt leeggemaakt. Hierdoor kan de encoder de status (gedeeltelijke tekens) behouden, zodat het volgende blok tekens correct kan coderen. Dit scenario is van invloed op UTF8 en UTF7, waarbij bepaalde tekens alleen kunnen worden gecodeerd nadat de encoder het aangrenzende teken of de aangrenzende tekens heeft ontvangen.
Wanneer AutoFlush deze optie is ingesteld false, StreamWriter wordt een beperkte hoeveelheid buffering uitgevoerd, zowel intern als mogelijk in de encoder vanaf de codering die u hebt doorgegeven. U kunt betere prestaties krijgen door in te falsestellen AutoFlush op , ervan uitgaande dat u altijd belt Close (of ten minste Flush) wanneer u klaar bent met schrijven met een StreamWriter.
Stel bijvoorbeeld in AutoFlushtrue wanneer u naar een apparaat schrijft waar de gebruiker direct feedback verwacht.
Console.Out is een van deze gevallen: het StreamWriter wordt intern gebruikt voor het schrijven om alle interne status leeg te Console maken, behalve de encoderstatus na elke aanroep naar StreamWriter.Write.
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.