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 StreamWriter scarica i dati del 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 determinare l'invio da parte di StreamWriter dei dati 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;
' 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. Se si imposta AutoFlush su true , i dati verranno scaricati dal buffer al flusso dopo ogni operazione di scrittura, ma lo stato del codificatore non verrà scaricato. In questo modo il codificatore può 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 su , presupponendo che si chiami Close sempre (o almeno Flush) al termine della scrittura con un oggetto StreamWriter.AutoFlushfalse
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: StreamWriter usato 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.
