StringWriter Classe

Référence

Définition

Espace de noms:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

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.

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

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

public class StringWriter : System.IO.TextWriter

[System.Serializable]
public class StringWriter : System.IO.TextWriter

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StringWriter : System.IO.TextWriter

type StringWriter = class
    inherit TextWriter

[<System.Serializable>]
type StringWriter = class
    inherit TextWriter

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StringWriter = class
    inherit TextWriter

Public Class StringWriter
Inherits TextWriter

Héritage: Object

TextWriter
StringWriter

Héritage: Object

MarshalByRefObject

TextWriter
StringWriter

Attributs: SerializableAttribute ComVisibleAttribute

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 en 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)WriteAsync(Char) méthode ou, une chaîne à la fois à l’aide de la Write(String)WriteAsync(String) méthode ou . En outre, vous pouvez écrire un caractère, un tableau de caractères ou une chaîne suivi de la fin de ligne de manière asynchrone avec l’une WriteLineAsync des méthodes.

Notes

Ce type implémente l’interface IDisposable, mais il n’a en fait aucune ressource à supprimer. Cela signifie que sa suppression 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 associées.

Action à réaliser...	Consultez l'exemple décrit dans cette rubrique...
Créer un fichier texte.	Procédure : écrire du texte dans un fichier
Écrire dans un fichier texte.	Procédure : écrire du texte dans un fichier
Lecture à partir d’un fichier texte.	Procédure : lire le texte d’un fichier
Ajoutez du texte à un fichier.	Procédure : ouvrir un fichier journal et y ajouter des éléments 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.	Procédure : lire et écrire dans un fichier de données créé récemment
Écrire dans un fichier binaire.	Procédure : lire et écrire dans un fichier de données créé récemment

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 StringBuilder spécifié.
StringWriter(StringBuilder, IFormatProvider)	Initialise une nouvelle instance de la classe StringWriter qui écrit dans le StringBuilder spécifié et qui possède le fournisseur de format spécifié.

Champs

CoreNewLine

Stocke les caractères de saut de ligne utilisés pour ce TextWriter.

(Hérité de TextWriter)

Propriétés

Encoding	Obtient le Encoding dans lequel 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 marque de fin de ligne utilisée pour le `TextWriter` actuel. (Hérité de TextWriter)

Méthodes

Close()	Ferme le StringWriter actuel et le flux sous-jacent.
Close()	Ferme le writer actuel et libère toutes les ressources système qui lui sont associées. (Hérité de TextWriter)
CreateObjRef(Type)	Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de 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 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 pour le writer actuel et provoque l'écriture des 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 pour le writer actuel et provoque l'écriture des données mises en mémoire tampon sur l'appareil sous-jacent.
FlushAsync()	Efface de façon asynchrone toutes les mémoires tampons pour le writer actuel et provoque l'écriture des données mises en mémoire tampon sur l'appareil sous-jacent. (Hérité de TextWriter)
FlushAsync(CancellationToken)	Efface de façon asynchrone toutes les mémoires tampons pour le writer actuel et provoque l'écriture des données mises en mémoire tampon sur l'appareil sous-jacent. (Hérité de TextWriter)
GetHashCode()	Fait office 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 en cours qui contrôle la stratégie de durée de vie de cette instance. (Hérité de MarshalByRefObject)
GetStringBuilder()	Retourne l’élément StringBuilder sous-jacent.
GetType()	Obtient le 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 Object actuel. (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 sur le `StringWriter` actuel jusqu’à présent.
Write(Boolean)	Écrit la représentation sous forme de texte 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 sous forme de texte d’une valeur décimale dans le flux de texte. (Hérité de TextWriter)
Write(Double)	Écrit la représentation sous forme de texte d’une valeur à virgule flottante de 8 octets dans le flux de texte. (Hérité de TextWriter)
Write(Int32)	Écrit la représentation sous forme de texte d’un entier signé de 4 octets dans le flux de texte. (Hérité de TextWriter)
Write(Int64)	Écrit la représentation sous forme de texte d’un entier signé de 8 octets dans le flux de texte. (Hérité de TextWriter)
Write(Object)	Écrit la représentation sous forme de texte 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 plage de caractères dans la chaîne actuelle.
Write(ReadOnlySpan<Char>)	Écrit une plage de caractères dans le flux de texte. (Hérité de TextWriter)
Write(Single)	Écrit la représentation sous forme de texte 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, en utilisant 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, en utilisant 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, en utilisant 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, en utilisant la même sémantique que la méthode Format(String, Object[]). (Hérité de TextWriter)
Write(StringBuilder)	Écrit la représentation sous forme de chaîne d’un générateur de chaîne dans la chaîne actuelle.
Write(StringBuilder)	Écrit un générateur de chaîne dans le flux de texte. (Hérité de TextWriter)
Write(UInt32)	Écrit la représentation sous forme de texte d’un entier non signé de 4 octets dans le flux de texte. (Hérité de TextWriter)
Write(UInt64)	Écrit la représentation sous forme de texte 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 de façon asynchrone un caractère dans le flux de texte. (Hérité de TextWriter)
WriteAsync(Char[])	Écrit de façon asynchrone un tableau de caractères dans le flux de texte. (Hérité de TextWriter)
WriteAsync(Char[], Int32, Int32)	Écrit un sous-tableau de caractères dans la chaîne de façon asynchrone.
WriteAsync(Char[], Int32, Int32)	Écrit de façon asynchrone un sous-tableau de caractères dans le flux de texte. (Hérité de TextWriter)
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Écrit de façon asynchrone une zone de mémoire de caractères dans la chaîne.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Écrit de façon asynchrone une zone de mémoire de caractères dans le flux de texte. (Hérité de TextWriter)
WriteAsync(String)	Écrit une chaîne dans la chaîne actuelle de façon asynchrone.
WriteAsync(String)	Écrit de façon asynchrone une chaîne dans le flux de texte. (Hérité de TextWriter)
WriteAsync(StringBuilder, CancellationToken)	Écrit de façon asynchrone la représentation sous forme de texte d’un générateur de chaîne dans la chaîne.
WriteAsync(StringBuilder, CancellationToken)	Écrit de façon asynchrone un générateur de chaîne dans le flux de texte. (Hérité de TextWriter)
WriteLine()	Écrit une marque de fin de ligne dans le flux de texte. (Hérité de TextWriter)
WriteLine(Boolean)	Écrit la représentation sous forme de texte 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 suivi d’une marque de fin de ligne dans le flux de texte. (Hérité de TextWriter)
WriteLine(Char[], Int32, Int32)	Écrit un sous-tableau 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 sous forme de texte 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 suivie d’une marque de fin de ligne dans le flux de texte. (Hérité de TextWriter)
WriteLine(Int32)	Écrit la représentation textuelle d’un entier signé de 4 octets suivie d’une marque de fin de ligne dans le flux de texte. (Hérité de TextWriter)
WriteLine(Int64)	Écrit la représentation sous forme de texte d’un entier signé de 8 octets suivie d’une marque de fin de ligne dans le flux de texte. (Hérité de TextWriter)
WriteLine(Object)	Écrit la représentation sous forme de texte d’un objet dans le flux de texte, en appelant la méthode `ToString` sur cet objet, suivie d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLine(ReadOnlySpan<Char>)	Écrit la représentation sous forme de texte d’une plage de caractères dans la chaîne, suivie d’une marque de fin de ligne.
WriteLine(ReadOnlySpan<Char>)	Écrit la représentation sous forme de texte d’une plage de caractères dans le flux de texte, suivie d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLine(Single)	Écrit la représentation sous forme de texte d’une valeur à virgule flottante de 4 octets suivie d’une marque de fin de ligne dans le flux de texte. (Hérité de TextWriter)
WriteLine(String)	Écrit une chaîne suivie d’une marque de fin de ligne dans le flux de texte. (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, en utilisant 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, en utilisant la même sémantique que Format(String, Object). (Hérité de TextWriter)
WriteLine(StringBuilder)	Écrit la représentation sous forme de texte d’un générateur de chaîne dans la chaîne, suivie d’une marque de fin de ligne.
WriteLine(StringBuilder)	Écrit la représentation sous forme de texte d’un générateur de chaîne dans le flux de texte, suivie d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLine(UInt32)	Écrit la représentation sous forme de texte d’un entier non signé de 4 octets suivie d’une marque de fin de ligne dans le flux de texte. (Hérité de TextWriter)
WriteLine(UInt64)	Écrit la représentation sous forme de texte d’un entier non signé de 8 octets suivie d’une marque de fin de ligne dans le flux de texte. (Hérité de TextWriter)
WriteLineAsync()	Écrit de façon asynchrone une marque de fin 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 caractère dans le flux de texte, suivi d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLineAsync(Char[])	Écrit de façon asynchrone un tableau de caractères suivi d’une marque de fin de ligne dans le flux de texte. (Hérité de TextWriter)
WriteLineAsync(Char[], Int32, Int32)	Écrit de façon asynchrone un sous-tableau de caractères dans la chaîne, suivi d’une marque de fin de ligne.
WriteLineAsync(Char[], Int32, Int32)	Écrit de façon asynchrone un sous-tableau de caractères dans le flux de texte, suivi d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Écrit de façon asynchrone la représentation sous forme de chaîne de la zone de mémoire de caractères dans la chaîne actuelle, suivie d’une marque de fin de ligne.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Écrit de façon asynchrone la représentation sous forme de texte d’une zone de mémoire de caractères dans le flux de texte, suivie d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLineAsync(String)	Écrit de façon asynchrone une chaîne dans la chaîne actuelle, suivie d’une marque de fin de ligne.
WriteLineAsync(String)	Écrit de façon asynchrone une chaîne dans le flux de texte, suivie d’une marque de fin de ligne. (Hérité de TextWriter)
WriteLineAsync(StringBuilder, CancellationToken)	Écrit de façon asynchrone la représentation sous forme de chaîne du générateur de chaîne dans la chaîne actuelle, suivie d’une marque de fin de ligne.
WriteLineAsync(StringBuilder, CancellationToken)	Écrit de façon asynchrone la représentation sous forme de texte d’un générateur de chaîne dans le flux de texte, suivie d’une marque de fin de ligne. (Hérité de TextWriter)

Implémentations d’interfaces explicites

IDisposable.Dispose()

Pour obtenir une description de ce membre, consultez Dispose().

(Hérité de TextWriter)

Méthodes d’extension

ConfigureAwait(IAsyncDisposable, Boolean)

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

S’applique à