StreamWriter.Close Méthode
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.
Ferme l’objet actuel StreamWriter et le flux sous-jacent.
public:
override void Close();
public override void Close();
override this.Close : unit -> unit
Public Overrides Sub Close ()
Exceptions
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()
Remarques
Cette méthode se substitue à Stream.Close.
Cette implémentation des appels de Close la Dispose méthode passant une true valeur.
Vous devez appeler Close pour vous assurer que toutes les données sont correctement écrites dans le flux sous-jacent. Après un appel à Close, toutes les opérations sur le StreamWriter site peuvent déclencher des exceptions. En cas d’espace insuffisant sur le disque, l’appel Close déclenche une exception.
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, 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.