StreamWriter.AutoFlush Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger ett värde som anger om StreamWriter kommer att tömma sin buffert till den underliggande strömmen efter varje anrop till 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 BooleanEgenskapsvärde
trueför att framtvinga StreamWriter att tömma bufferten, annars . false
Exempel
I följande exempel visas syntaxen för att använda egenskapen AutoFlush .
// 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
Kommentarer
Om dataströmmen töms töms inte dess underliggande kodare om du inte uttryckligen anropar Flush eller Close.
true Inställningen AutoFlush innebär att data rensas från bufferten till strömmen efter varje skrivåtgärd, men kodartillståndet rensas inte. Detta gör att kodaren kan behålla sitt tillstånd (partiella tecken) så att nästa teckenblock kan kodas korrekt. Det här scenariot påverkar UTF8 och UTF7 där vissa tecken bara kan kodas efter att kodaren har fått det intilliggande tecknet eller tecknen.
När AutoFlush är inställt på falsekommer StreamWriter att göra en begränsad mängd buffring, både internt och potentiellt i kodaren från kodningen som du skickade in. Du kan få bättre prestanda genom att ange AutoFlush till false, förutsatt att du alltid anropar Close (eller åtminstone Flush) när du är klar med att skriva med en StreamWriter.
Ange till true exempel AutoFlush när du skriver till en enhet där användaren förväntar sig omedelbar feedback.
Console.Out är ett av dessa fall: Det StreamWriter som används internt för att skriva rensar Console alla dess interna tillstånd förutom kodartillståndet efter varje anrop till StreamWriter.Write.
En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.