StreamWriter.AutoFlush Proprietà

Definizione

Ottiene o imposta un valore che indica se StreamWriter invia i dati contenuti nel proprio buffer nel flusso sottostante dopo ogni chiamata a Write(Char).Gets or sets a value indicating whether the StreamWriter will flush its buffer to the underlying stream after every call to 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à

true per determinare l'invio da parte di StreamWriter dei dati del buffer; in caso contrario false.true to force StreamWriter to flush its buffer; otherwise, false.

Esempi

Nell'esempio seguente viene illustrata la sintassi per l'utilizzo della proprietà AutoFlush.The following example shows the syntax for using the AutoFlush property.

// 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 svuotamento del flusso non Scarica il codificatore sottostante a meno che non si chiami in modo esplicito Flush o Close.Flushing the stream will not flush its underlying encoder unless you explicitly call Flush or Close. Impostando AutoFlush su true significa che i dati verranno scaricati dal buffer nel flusso dopo ogni operazione di scrittura, ma lo stato del codificatore non verrà scaricato.Setting AutoFlush to true means that data will be flushed from the buffer to the stream after each write operation, but the encoder state will not be flushed. In questo modo, il codificatore può mantenerne lo stato (caratteri parziali) in modo da codificare correttamente il blocco successivo di caratteri.This allows the encoder to keep its state (partial characters) so that it can encode the next block of characters correctly. Questo scenario riguarda UTF8 e UTF7, in cui alcuni caratteri possono essere codificati solo dopo che il codificatore riceve il carattere o i caratteri adiacenti.This scenario affects UTF8 and UTF7 where certain characters can only be encoded after the encoder receives the adjacent character or characters.

Quando AutoFlush è impostato su false, StreamWriter eseguirà una quantità limitata di buffering, sia internamente che potenzialmente nel codificatore dalla codifica passata.When AutoFlush is set to false, StreamWriter will do a limited amount of buffering, both internally and potentially in the encoder from the encoding you passed in. È possibile ottenere prestazioni migliori impostando AutoFlush su false, supponendo di chiamare sempre Close (o almeno Flush) al termine della scrittura con un StreamWriter.You can get better performance by setting AutoFlush to false, assuming that you always call Close (or at least Flush) when you're done writing with a StreamWriter.

Ad esempio, impostare AutoFlush su true quando si scrive in un dispositivo in cui l'utente aspetta il feedback immediato.For example, set AutoFlush to true when you are writing to a device where the user expects immediate feedback. Console.Out è uno di questi casi: il StreamWriter usato internamente per la scrittura in Console svuota tutto lo stato interno, ad eccezione dello stato del codificatore dopo ogni chiamata a StreamWriter.Write.Console.Out is one of these cases: The StreamWriter used internally for writing to Console flushes all its internal state except the encoder state after every call to StreamWriter.Write.

Per un elenco delle attività di I/O comuni, vedere attività di i/o comuni.For a list of common I/O tasks, see Common I/O Tasks.

Si applica a

Vedi anche