StreamWriter.AutoFlush Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che indica se l'oggetto StreamWriter scarica il buffer nel flusso sottostante dopo ogni chiamata a 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 BooleanValore della proprietà
true per forzare StreamWriter lo scaricamento del buffer; in caso contrario, false.
Esempio
Nell'esempio seguente viene illustrata la sintassi per l'utilizzo della AutoFlush proprietà .
// 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
Commenti
Lo scaricamento del flusso non scarica il codificatore sottostante a meno che non si chiami Flush in modo esplicito o Close. L'impostazione AutoFlush su true indica che i dati verranno scaricati dal buffer al flusso dopo ogni operazione di scrittura, ma lo stato del codificatore non verrà scaricato. Ciò consente al codificatore di mantenere lo stato (caratteri parziali) in modo che possa codificare correttamente il blocco successivo di caratteri. Questo scenario influisce su UTF8 e UTF7 in cui determinati caratteri possono essere codificati solo dopo che il codificatore riceve il carattere o i caratteri adiacenti.
Quando AutoFlush è impostato su false, StreamWriter eseguirà una quantità limitata di buffering, sia internamente che potenzialmente nel codificatore dalla codifica passata. È possibile ottenere prestazioni migliori impostando AutoFlush su , presupponendo che venga sempre chiamato false (o almeno Close) al termine della scrittura con un oggetto FlushStreamWriter.
Ad esempio, impostare su AutoFlushtrue quando si scrive in un dispositivo in cui l'utente prevede un feedback immediato.
Console.Out è uno di questi casi: usato StreamWriter internamente per la scrittura per Console scaricare tutto lo stato interno, ad eccezione dello stato del codificatore dopo ogni chiamata a StreamWriter.Write.
Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.
