StringWriter.Close Méthode

Définition

Ferme le StringWriter actuel et le flux sous-jacent.

public:
 override void Close();
public override void Close ();
override this.Close : unit -> unit
Public Overrides Sub Close ()

Exemples

Cet exemple de code fait partie d’un exemple plus grand fourni pour le StringWriter(StringBuilder) constructeur.

strWriter->Close();

// Since the StringWriter is closed, an exception will 
// be thrown if the Write method is called. However, 
// the StringBuilder can still manipulate the string.
strBuilder->Insert( 0, "Invalid " );
Console::WriteLine( strWriter->ToString() );
strWriter.Close();

// Since the StringWriter is closed, an exception will
// be thrown if the Write method is called. However,
// the StringBuilder can still manipulate the string.
strBuilder.Insert(0, "Invalid ");
Console.WriteLine(strWriter.ToString());
strWriter.Close()

' Since the StringWriter is closed, an exception will 
' be thrown if the Write method is called. However, 
' the StringBuilder can still manipulate the string.
strBuilder.Insert(0, "Invalid ")
Console.WriteLine(strWriter.ToString())

Remarques

Pour obtenir un exemple de création d’un fichier et d’écriture de texte dans un fichier, consultez Guide pratique pour écrire du texte dans un fichier. Pour obtenir un exemple de lecture de texte à partir d’un fichier, consultez Guide pratique pour lire du texte à partir d’un fichier. Pour obtenir un exemple de lecture et d’écriture dans un fichier binaire, consultez Guide pratique pour lire et écrire dans un fichier de données nouvellement créé.

Cette méthode se substitue à Stream.Close.

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

Le vidage du flux ne videra pas son encodeur sous-jacent, sauf si vous appelez Closeexplicitement . La définition de AutoFlush 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.

S’applique à

Voir aussi