StreamWriter.AutoFlush Proprietà

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

Origine:

StreamWriter.cs

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, set

Public Overridable Property AutoFlush As Boolean

Valore della proprietà

Boolean

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. 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 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.

Vedi anche

• I/O di file e flusso
• Procedura: Leggere testo da un file
• Procedura: Scrivere un testo in un file