Stream.Flush Méthode

Définition

En cas de remplacement dans une classe dérivée, efface toutes les mémoires tampons pour ce flux et provoque l'écriture de toutes les données se trouvant dans des mémoires tampons sur l'appareil sous-jacent.When overridden in a derived class, clears all buffers for this stream and causes any buffered data to be written to the underlying device.

public:
 abstract void Flush();
public abstract void Flush ();
abstract member Flush : unit -> unit
Public MustOverride Sub Flush ()

Exceptions

Une erreur d’E/S se produit.An I/O error occurs.

Remarques

Substituez Flush sur les flux qui implémentent une mémoire tampon.Override Flush on streams that implement a buffer. Utilisez cette méthode pour déplacer les informations d’une mémoire tampon sous-jacente vers la destination, effacer la mémoire tampon, ou les deux.Use this method to move any information from an underlying buffer to its destination, clear the buffer, or both. Selon l’état de l’objet, vous devrez peut-être modifier la position actuelle dans le flux (par exemple, si le flux sous-jacent prend en charge la recherche).Depending upon the state of the object, you might have to modify the current position within the stream (for example, if the underlying stream supports seeking). Pour plus d’informations, consultez CanSeek.For additional information see CanSeek.

Dans une classe dérivée de Stream qui ne prend pas en charge l’écriture, Flush est généralement implémenté comme une méthode vide pour garantir une compatibilité complète avec les autres types de Stream, car il est valide pour vider un flux en lecture seule.In a class derived from Stream that doesn't support writing, Flush is typically implemented as an empty method to ensure full compatibility with other Stream types since it's valid to flush a read-only stream.

Lorsque vous utilisez la classe StreamWriter ou BinaryWriter, ne videz pas l’objet Stream de base.When using the StreamWriter or BinaryWriter class, do not flush the base Stream object. Au lieu de cela, utilisez la méthode Flush ou Close de la classe, qui garantit que les données sont d’abord vidées dans le flux sous-jacent, puis écrites dans le fichier.Instead, use the class's Flush or Close method, which makes sure that the data is flushed to the underlying stream first and then written to the file.

S’applique à

Voir aussi