StringWriter Classe

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

Source:

StringWriter.cs

Implémente un TextWriter pour écrire des informations dans une chaîne. Les informations sont stockées dans un StringBuildersous-jacent.

public ref class StringWriter : System::IO::TextWriter

public class StringWriter : System.IO.TextWriter

type StringWriter = class
    inherit TextWriter

Public Class StringWriter
Inherits TextWriter

Héritage

Object

MarshalByRefObject

TextWriter

StringWriter

Exemples

L’exemple de code suivant illustre la création d’un paragraphe continu à partir d’un groupe de phrases à double espacement, puis la conversion du paragraphe vers le texte d’origine.

using namespace System;
using namespace System::IO;
int main()
{
   String^ textReaderText = "TextReader is the abstract base "
   "class of StreamReader and StringReader, which read "
   "characters from streams and strings, respectively.\n\n"
   "Create an instance of TextReader to open a text file "
   "for reading a specified range of characters, or to "
   "create a reader based on an existing stream.\n\n"
   "You can also use an instance of TextReader to read "
   "text from a custom backing store using the same "
   "APIs you would use for a string or a stream.\n\n";
   Console::WriteLine(  "Original text:\n\n{0}", textReaderText );

   // From textReaderText, create a continuous paragraph 
   // with two spaces between each sentence.
      String^ aLine;
   String^ aParagraph;
   StringReader^ strReader = gcnew StringReader( textReaderText );
   while ( true )
   {
      aLine = strReader->ReadLine();
      if ( aLine != nullptr )
      {
         aParagraph = String::Concat( aParagraph, aLine,  " " );
      }
      else
      {
         aParagraph = String::Concat( aParagraph,  "\n" );
         break;
      }
   }

   Console::WriteLine(  "Modified text:\n\n{0}", aParagraph );
   
   // Re-create textReaderText from aParagraph.
   int intCharacter;
   Char convertedCharacter;
   StringWriter^ strWriter = gcnew StringWriter;
   strReader = gcnew StringReader( aParagraph );
   while ( true )
   {
      intCharacter = strReader->Read();
      
      // Check for the end of the string 
      // before converting to a character.
      if ( intCharacter == -1 )
            break;

      
      convertedCharacter = Convert::ToChar( intCharacter );
      if ( convertedCharacter == '.' )
      {
         strWriter->Write(  ".\n\n" );
         
         // Bypass the spaces between sentences.
         strReader->Read();
         strReader->Read();
      }
      else
      {
         strWriter->Write( convertedCharacter );
      }
   }

   Console::WriteLine(  "\nOriginal text:\n\n{0}", strWriter->ToString() );
}

using System;
using System.IO;

class StringRW
{
    static void Main()
    {
        string textReaderText = "TextReader is the abstract base " +
            "class of StreamReader and StringReader, which read " +
            "characters from streams and strings, respectively.\n\n" +

            "Create an instance of TextReader to open a text file " +
            "for reading a specified range of characters, or to " +
            "create a reader based on an existing stream.\n\n" +

            "You can also use an instance of TextReader to read " +
            "text from a custom backing store using the same " +
            "APIs you would use for a string or a stream.\n\n";

        Console.WriteLine("Original text:\n\n{0}", textReaderText);

        // From textReaderText, create a continuous paragraph
        // with two spaces between each sentence.
        string aLine, aParagraph = null;
        StringReader strReader = new StringReader(textReaderText);
        while(true)
        {
            aLine = strReader.ReadLine();
            if(aLine != null)
            {
                aParagraph = aParagraph + aLine + " ";
            }
            else
            {
                aParagraph = aParagraph + "\n";
                break;
            }
        }
        Console.WriteLine("Modified text:\n\n{0}", aParagraph);

        // Re-create textReaderText from aParagraph.
        int intCharacter;
        char convertedCharacter;
        StringWriter strWriter = new StringWriter();
        strReader = new StringReader(aParagraph);
        while(true)
        {
            intCharacter = strReader.Read();

            // Check for the end of the string
            // before converting to a character.
            if(intCharacter == -1) break;

            convertedCharacter = (char)intCharacter;
            if(convertedCharacter == '.')
            {
                strWriter.Write(".\n\n");

                // Bypass the spaces between sentences.
                strReader.Read();
                strReader.Read();
            }
            else
            {
                strWriter.Write(convertedCharacter);
            }
        }
        Console.WriteLine("\nOriginal text:\n\n{0}",
            strWriter.ToString());
    }
}

Option Explicit
Option Strict

Imports System.IO

Public Class StrReader

    Shared Sub Main()
    
        Dim textReaderText As String = "TextReader is the " & _
            "abstract base class of StreamReader and " & _
            "StringReader, which read characters from streams " & _
            "and strings, respectively." & _
            vbCrLf & vbCrLf & _
            "Create an instance of TextReader to open a text " & _
            "file for reading a specified range of characters, " & _
            "or to create a reader based on an existing stream." & _
            vbCrLf & vbCrLf & _
            "You can also use an instance of TextReader to read " & _
            "text from a custom backing store using the same " & _
            "APIs you would use for a string or a stream." & _
            vbCrLf & vbCrLf

        Console.WriteLine("Original text:" & vbCrLf & vbCrLf & _
            textReaderText)

        ' From textReaderText, create a continuous paragraph 
        ' with two spaces between each sentence.
        Dim aLine, aParagraph As String
        Dim strReader As New StringReader(textReaderText)
        While True
            aLine = strReader.ReadLine()
            If aLine Is Nothing Then
                aParagraph = aParagraph & vbCrLf
                Exit While
            Else
                aParagraph = aParagraph & aLine & " "
            End If
        End While
        Console.WriteLine("Modified text:" & vbCrLf & vbCrLf & _ 
            aParagraph)
    
        ' Re-create textReaderText from aParagraph.
        Dim intCharacter As Integer 
        Dim convertedCharacter As Char 
        Dim strWriter As New StringWriter()
        strReader = New StringReader(aParagraph)
        While True
            intCharacter = strReader.Read()

            ' Check for the end of the string 
            ' before converting to a character.
            If intCharacter = -1 Then
                Exit While
            End If

            convertedCharacter = Convert.ToChar(intCharacter)
            If convertedCharacter = "."C Then
                strWriter.Write("." & vbCrLf & vbCrLf)

                ' Bypass the spaces between sentences.
                strReader.Read()
                strReader.Read()
            Else
                strWriter.Write(convertedCharacter)
            End If
        End While
        Console.WriteLine(vbCrLf & "Original text:" & vbCrLf & _ 
            vbCrLf & strWriter.ToString())

    End Sub
End Class

Remarques

StringWriter vous permet d’écrire dans une chaîne de manière synchrone ou asynchrone. Vous pouvez écrire un caractère à la fois avec la Write(Char) ou la méthode WriteAsync(Char), une chaîne à la fois à l’aide du Write(String) ou de la méthode WriteAsync(String). En outre, vous pouvez écrire un caractère, un tableau de caractères ou une chaîne suivi de la marque de fin de ligne de manière asynchrone avec l’une des méthodes WriteLineAsync.

Note

Ce type implémente l’interface IDisposable, mais n’a pas réellement de ressources à supprimer. Cela signifie que la suppression directe en appelant directement Dispose() ou en utilisant une construction de langage telle que using (en C#) ou Using (en Visual Basic) n’est pas nécessaire.

Le tableau suivant répertorie des exemples d’autres tâches d’E/S classiques ou connexes.

Pour ce faire...	Consultez l’exemple de cette rubrique...
Créez un fichier texte.	Comment : écrire du texte dans un fichier
Écrivez dans un fichier texte.	Comment : écrire du texte dans un fichier
Lire à partir d’un fichier texte.	Guide pratique pour lire du texte à partir d’un fichier
Ajoutez du texte à un fichier.	Comment : ouvrir et ajouter à un fichier journal File.AppendText FileInfo.AppendText
Obtenez la taille d’un fichier.	FileInfo.Length
Obtenir les attributs d’un fichier.	File.GetAttributes
Définissez les attributs d’un fichier.	File.SetAttributes
Déterminez si un fichier existe.	File.Exists
Lire à partir d’un fichier binaire.	Comment : lire et écrire dans un fichier de données nouvellement créé
Écrivez dans un fichier binaire.	Comment : lire et écrire dans un fichier de données nouvellement créé

Constructeurs

StringWriter()	Initialise une nouvelle instance de la classe StringWriter.
StringWriter(IFormatProvider)	Initialise une nouvelle instance de la classe StringWriter avec le contrôle de format spécifié.
StringWriter(StringBuilder)	Initialise une nouvelle instance de la classe StringWriter qui écrit dans le StringBuilderspécifié.
StringWriter(StringBuilder, IFormatProvider)	Initialise une nouvelle instance de la classe StringWriter qui écrit dans le StringBuilder spécifié et a le fournisseur de format spécifié.

Champs

CoreNewLine

Stocke les caractères de ligne utilisés pour cette TextWriter. (Hérité de TextWriter)

Propriétés

Encoding	Obtient la Encoding dans laquelle la sortie est écrite.
FormatProvider	Obtient un objet qui contrôle la mise en forme. (Hérité de TextWriter)
NewLine	Obtient ou définit la chaîne de fin de ligne utilisée par la TextWriteractuelle. (Hérité de TextWriter)

Méthodes

Close()	Ferme le StringWriter actuel et le flux sous-jacent.
CreateObjRef(Type)	Crée un objet qui contient toutes les informations pertinentes requises pour générer un proxy utilisé pour communiquer avec un objet distant. (Hérité de MarshalByRefObject)
Dispose()	Libère toutes les ressources utilisées par l’objet TextWriter. (Hérité de TextWriter)
Dispose(Boolean)	Libère les ressources non managées utilisées par le StringWriter et libère éventuellement les ressources managées.
DisposeAsync()	Libère de façon asynchrone toutes les ressources utilisées par l’objet TextWriter. (Hérité de TextWriter)
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
Flush()	Efface toutes les mémoires tampons de l’enregistreur actuel et entraîne l’écriture de toutes les données mises en mémoire tampon sur l’appareil sous-jacent. (Hérité de TextWriter)
FlushAsync()	Efface de façon asynchrone toutes les mémoires tampons de l’enregistreur actuel et entraîne l’écriture de toutes les données mises en mémoire tampon sur l’appareil sous-jacent.
FlushAsync(CancellationToken)	Efface de façon asynchrone toutes les mémoires tampons de l’enregistreur actuel et entraîne l’écriture de toutes les données mises en mémoire tampon sur l’appareil sous-jacent. (Hérité de TextWriter)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetLifetimeService()	Obsolète. Récupère l’objet de service de durée de vie actuel qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetStringBuilder()	Retourne le StringBuildersous-jacent .
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
InitializeLifetimeService()	Obsolète. Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
MemberwiseClone(Boolean)	Crée une copie superficielle de l’objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject)
ToString()	Retourne une chaîne contenant les caractères écrits dans la StringWriter actuelle jusqu’à présent.
Write(Boolean)	Écrit la représentation textuelle d’une valeur Boolean dans le flux de texte. (Hérité de TextWriter)
Write(Char)	Écrit un caractère dans la chaîne.
Write(Char[])	Écrit un tableau de caractères dans le flux de texte. (Hérité de TextWriter)
Write(Char[], Int32, Int32)	Écrit un sous-tableau de caractères dans la chaîne.
Write(Decimal)	Écrit la représentation textuelle d’une valeur décimale dans le flux de texte. (Hérité de TextWriter)
Write(Double)	Écrit la représentation textuelle d’une valeur à virgule flottante de 8 octets dans le flux de texte. (Hérité de TextWriter)
Write(Int32)	Écrit la représentation textuelle d’un entier signé de 4 octets dans le flux de texte. (Hérité de TextWriter)
Write(Int64)	Écrit la représentation textuelle d’un entier signé de 8 octets dans le flux de texte. (Hérité de TextWriter)
Write(Object)	Écrit la représentation textuelle d’un objet dans le flux de texte en appelant la méthode ToString sur cet objet. (Hérité de TextWriter)
Write(ReadOnlySpan<Char>)	Écrit la représentation sous forme de chaîne d’une étendue de caractères dans la chaîne actuelle.
Write(Single)	Écrit la représentation textuelle d’une valeur à virgule flottante de 4 octets dans le flux de texte. (Hérité de TextWriter)
Write(String)	Écrit une chaîne dans la chaîne actuelle.
Write(String, Object)	Écrit une chaîne mise en forme dans le flux de texte à l’aide de la même sémantique que la méthode Format(String, Object). (Hérité de TextWriter)
Write(String, Object, Object)	Écrit une chaîne mise en forme dans le flux de texte à l’aide de la même sémantique que la méthode Format(String, Object, Object). (Hérité de TextWriter)
Write(String, Object, Object, Object)	Écrit une chaîne mise en forme dans le flux de texte à l’aide de la même sémantique que la méthode Format(String, Object, Object, Object). (Hérité de TextWriter)
Write(String, Object[])	Écrit une chaîne mise en forme dans le flux de texte à l’aide de la même sémantique que la méthode Format(String, Object[]). (Hérité de TextWriter)
Write(String, ReadOnlySpan<Object>)	Écrit une chaîne mise en forme dans le flux de texte à l’aide de la même sémantique que Format(String, ReadOnlySpan<Object>). (Hérité de TextWriter)
Write(StringBuilder)	Écrit la représentation sous forme de chaîne d’un générateur de chaînes dans la chaîne actuelle.
Write(UInt32)	Écrit la représentation textuelle d’un entier non signé de 4 octets dans le flux de texte. (Hérité de TextWriter)
Write(UInt64)	Écrit la représentation textuelle d’un entier non signé de 8 octets dans le flux de texte. (Hérité de TextWriter)
WriteAsync(Char)	Écrit un caractère dans la chaîne de façon asynchrone.
WriteAsync(Char[])	Écrit un tableau de caractères dans le flux de texte de manière asynchrone. (Hérité de TextWriter)
WriteAsync(Char[], Int32, Int32)	Écrit un sous-tableau de caractères dans la chaîne de manière asynchrone.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Écrit de façon asynchrone une région de mémoire de caractères dans la chaîne.
WriteAsync(String)	Écrit une chaîne dans la chaîne actuelle de façon asynchrone.
WriteAsync(StringBuilder, CancellationToken)	Écrit de façon asynchrone la représentation textuelle d’un générateur de chaînes dans la chaîne.
WriteLine()	Écrit un terminateur de ligne dans le flux de texte. (Hérité de TextWriter)
WriteLine(Boolean)	Écrit la représentation textuelle d’une valeur Boolean dans le flux de texte, suivie d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLine(Char)	Écrit un caractère dans le flux de texte, suivi d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLine(Char[])	Écrit un tableau de caractères dans le flux de texte, suivi d’un terminateur de ligne. (Hérité de TextWriter)
WriteLine(Char[], Int32, Int32)	Écrit un sous-narrateur de caractères dans le flux de texte, suivi d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLine(Decimal)	Écrit la représentation textuelle d’une valeur décimale dans le flux de texte, suivie d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLine(Double)	Écrit la représentation textuelle d’une valeur à virgule flottante de 8 octets dans le flux de texte, suivie d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLine(Int32)	Écrit la représentation textuelle d’un entier signé de 4 octets dans le flux de texte, suivi d’un terminateur de ligne. (Hérité de TextWriter)
WriteLine(Int64)	Écrit la représentation textuelle d’un entier signé de 8 octets dans le flux de texte, suivi d’un terminateur de ligne. (Hérité de TextWriter)
WriteLine(Object)	Écrit la représentation textuelle d’un objet dans le flux de texte, en appelant la méthode ToString sur cet objet, suivie d’un terminateur de ligne. (Hérité de TextWriter)
WriteLine(ReadOnlySpan<Char>)	Écrit la représentation textuelle d’une étendue de caractères dans la chaîne, suivie d’une marque de fin de ligne.
WriteLine(Single)	Écrit la représentation textuelle d’une valeur à virgule flottante de 4 octets dans le flux de texte, suivie d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLine(String)	Écrit une chaîne dans le flux de texte, suivie d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLine(String, Object)	Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object). (Hérité de TextWriter)
WriteLine(String, Object, Object)	Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object, Object). (Hérité de TextWriter)
WriteLine(String, Object, Object, Object)	Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte à l’aide de la même sémantique que Format(String, Object). (Hérité de TextWriter)
WriteLine(String, Object[])	Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte à l’aide de la même sémantique que Format(String, Object). (Hérité de TextWriter)
WriteLine(String, ReadOnlySpan<Object>)	Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte à l’aide de la même sémantique que Format(String, ReadOnlySpan<Object>). (Hérité de TextWriter)
WriteLine(StringBuilder)	Écrit la représentation textuelle d’un générateur de chaînes dans la chaîne, suivie d’une marque de fin de ligne.
WriteLine(UInt32)	Écrit la représentation textuelle d’un entier non signé de 4 octets dans le flux de texte, suivie d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLine(UInt64)	Écrit la représentation textuelle d’un entier non signé de 8 octets dans le flux de texte, suivie d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLineAsync()	Écrit de façon asynchrone un terminateur de ligne dans le flux de texte. (Hérité de TextWriter)
WriteLineAsync(Char)	Écrit de façon asynchrone un caractère dans la chaîne, suivi d’une marque de fin de ligne.
WriteLineAsync(Char[])	Écrit de façon asynchrone un tableau de caractères dans le flux de texte, suivi d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLineAsync(Char[], Int32, Int32)	Écrit de façon asynchrone un sous-narrateur de caractères dans la chaîne, suivi d’un terminateur de ligne.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Écrit de façon asynchrone la représentation sous forme de chaîne de la région de mémoire de caractères dans la chaîne actuelle, suivie d’une marque de fin de ligne.
WriteLineAsync(String)	Écrit de façon asynchrone une chaîne dans la chaîne actuelle, suivie d’un terminateur de ligne.
WriteLineAsync(StringBuilder, CancellationToken)	Écrit de façon asynchrone la représentation sous forme de chaîne du générateur de chaînes dans la chaîne actuelle, suivie d’un terminateur de ligne.

Méthodes d’extension

ConfigureAwait(IAsyncDisposable, Boolean)

Configure la façon dont les attentes sur les tâches retournées à partir d’un jetable asynchrone sont effectuées.

Voir aussi

• StringBuilder
• StringReader
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier