StreamWriter.AutoFlush Propriété

  • Référence

Définition

Espace de noms:
System.IO
Assembly:
System.IO.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll

Obtient ou définit une valeur indiquant si StreamWriter vide sa mémoire tampon vers le flux sous-jacent après chaque appel à 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

Valeur de propriété

Boolean

true pour forcer StreamWriter à vider sa mémoire tampon ; sinon, false.

Exemples

L’exemple suivant illustre la syntaxe d’utilisation de la AutoFlush propriété.

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

Remarques

Le vidage du flux ne vide pas son encodeur sous-jacent, sauf si vous appelez explicitement Flush ou Close . La définition de la valeur AutoFlush true signifie que les données seront vidées de la mémoire tampon vers le flux après chaque opération d’écriture, mais que l’état de l’encodeur ne sera pas vidé. Cela permet à l’encodeur de conserver son état (caractères partiels) afin qu’il puisse coder correctement le bloc de caractères suivant. Ce scénario affecte UTF8 et UTF7, où certains caractères ne peuvent être codés que lorsque l’encodeur reçoit le ou les caractères adjacents.

Lorsque AutoFlush a la valeur false , effectue StreamWriter une quantité limitée de mise en mémoire tampon, à la fois en interne et potentiellement dans l’encodeur à partir de l’encodage que vous avez passé. Vous pouvez obtenir de meilleures performances en affectant AutoFlush à false la valeur, en supposant que vous appelez toujours Close (ou au moins Flush ) quand vous avez terminé l’écriture avec un StreamWriter .

Par exemple, affectez AutoFlush true la valeur lorsque vous écrivez à un appareil où l’utilisateur attend des commentaires immédiats. Console.Out est l’un des cas suivants : StreamWriter utilisé en interne pour écrire pour Console Vider tout son état interne à l’exception de l’état de l’encodeur après chaque appel à StreamWriter.Write .

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.

S’applique à

Voir aussi