StringWriter Classe
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.
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
[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
- Héritage
- Attributs
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 |
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 |
Méthodes
Close() |
Ferme le StringWriter actuel et le flux sous-jacent. |
Close() |
Ferme l’enregistreur actuel et libère toutes les ressources système associées à l’enregistreur. (Hérité de TextWriter) |
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() |
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) |
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 |
Write(Boolean) |
Écrit la représentation textuelle d’une valeur |
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 |
Write(ReadOnlySpan<Char>) |
Écrit la représentation sous forme de chaîne d’une étendue de caractères dans la chaîne actuelle. |
Write(ReadOnlySpan<Char>) |
Écrit une étendue de caractères dans le flux de texte. (Hérité de TextWriter) |
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(StringBuilder) |
Écrit un générateur de chaînes dans le flux de texte. (Hérité de TextWriter) |
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 caractère dans le flux de texte de manière asynchrone. (Hérité de TextWriter) |
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(Char[], Int32, Int32) |
Écrit un sous-tableau de caractères dans le flux de texte de manière asynchrone. (Hérité de TextWriter) |
WriteAsync(ReadOnlyMemory<Char>, CancellationToken) |
Écrit de façon asynchrone une région de mémoire de caractères dans la chaîne. |
WriteAsync(ReadOnlyMemory<Char>, CancellationToken) |
Écrit de façon asynchrone une région 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 une chaîne dans le flux de texte de manière asynchrone. (Hérité de TextWriter) |
WriteAsync(StringBuilder, CancellationToken) |
Écrit de façon asynchrone la représentation textuelle d’un générateur de chaînes dans la chaîne. |
WriteAsync(StringBuilder, CancellationToken) |
Écrit de façon asynchrone un générateur de chaînes dans le flux de texte. (Hérité de TextWriter) |
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 |
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 |
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(ReadOnlySpan<Char>) |
Écrit la représentation textuelle d’une étendue de caractères dans le flux de texte, suivie d’un terminateur de ligne. (Hérité de TextWriter) |
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(StringBuilder) |
Écrit la représentation textuelle d’un générateur de chaînes dans le flux de texte, suivie d’une marque de fin de ligne. (Hérité de TextWriter) |
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 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 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(Char[], Int32, Int32) |
Écrit de façon asynchrone un sous-narrateur 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 région 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 manière asynchrone la représentation textuelle d’une région de mémoire de caractères dans le flux de texte, suivie d’un terminateur de ligne. (Hérité de TextWriter) |
WriteLineAsync(String) |
Écrit de façon asynchrone une chaîne dans la chaîne actuelle, suivie d’un terminateur 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înes dans la chaîne actuelle, suivie d’un terminateur de ligne. |
WriteLineAsync(StringBuilder, CancellationToken) |
Écrit de façon asynchrone la représentation textuelle d’un générateur de chaînes 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 jetable asynchrone sont effectuées. |
S’applique à
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour