StreamWriter.AutoFlush Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur indiquant si la StreamWriter mémoire tampon videra sa mémoire tampon sur 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, setPublic Overridable Property AutoFlush As BooleanValeur de propriété
true pour forcer StreamWriter le vidage de sa mémoire tampon ; sinon, false.
Exemples
L’exemple suivant montre 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
Remarques
Le vidage du flux ne vide pas son encodeur sous-jacent, sauf si vous appelez Flush explicitement ou Close.
true La définition AutoFlush 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 encoder correctement le bloc de caractères suivant. Ce scénario affecte UTF8 et UTF7, où certains caractères ne peuvent être encodés qu’une fois que l’encodeur reçoit le caractère ou les caractères adjacents.
Quand AutoFlush la valeur est définie false, StreamWriter effectue 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 définissant falseAutoFlush sur , en supposant que vous appelez Close toujours (ou au moinsFlush) lorsque vous avez terminé d’écrire avec un StreamWriter.
Par exemple, définissez AutoFlushtrue la valeur lorsque vous écrivez sur un appareil où l’utilisateur attend des commentaires immédiats.
Console.Out est l’un des cas suivants : utilisé StreamWriter 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.