StringWriter.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 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 Close
explicitement . 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.