StreamWriter.Close Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Source:

StreamWriter.cs

Ferme l’objet StreamWriter actuel et le flux sous-jacent.

public:
 override void Close();

public override void Close ();

override this.Close : unit -> unit

Public Overrides Sub Close ()

Exceptions

EncoderFallbackException

L’encodage actuel ne prend pas en charge l’affichage de la moitié d’une paire de substitution Unicode.

Exemples

L’exemple de code suivant illustre la Close méthode.

// close the file by closing the writer
sw->Close();

// close the file by closing the writer
sw.Close();

' Close the file by closing the writer.
Sw.Close()

Remarques

Cette méthode se substitue à Stream.Close.

Cette implémentation de Close appelle la Dispose méthode en passant une true valeur.

Vous devez appeler Close pour vous assurer que toutes les données sont correctement écrites dans le flux sous-jacent. À la suite d’un appel à Close, toutes les opérations sur le StreamWriter peuvent déclencher des exceptions. S’il n’y a pas suffisamment d’espace sur le disque, l’appel Close déclenche une exception.

Le vidage du flux ne videra pas son encodeur sous-jacent, sauf si vous appelez Flush explicitement ou Close. La définition AutoFlush de sur true signifie que les données seront vidées de la mémoire tampon vers le flux, 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 a reçu le ou les caractères adjacents.

Voir aussi

• Fichier et flux de données E/S
• Procédure : lire le texte d’un fichier
• Procédure : écrire du texte dans un fichier