Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

StreamWriter.Close, méthode

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

Espace de noms :  System.IO
Assembly :  mscorlib (dans mscorlib.dll)

public override void Close()

ExceptionCondition
EncoderFallbackException

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

Cette méthode substitue Close.

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

Vous devez appeler Close pour vérifier que toutes les données sont correctement écrites dans le flux sous-jacent. Suite à un appel à Close, les opérations sur StreamWriter peuvent lever des exceptions. Si l'espace sur le disque n'est pas suffisant, l'appel à Close lèvera une exception.

Le vidage du flux de données n'entraîne pas le vidage de son encodeur sous-jacent, à moins d'appeler de manière explicite Flush ou Close. L'affectation de la valeur true à AutoFlush signifie que les données sont vidées de la mémoire tampon vers le flux, mais que l'état de l'encodeur n'est pas vidé. Ceci permet à l'encodeur de garder son état (caractères partiels) et d'encoder le bloc de caractères suivant correctement. Ce scénario affecte UTF8 et UTF7, où certains caractères peuvent uniquement être encodés après que l'encodeur a reçu les caractères contigus.

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


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


.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Afficher: