TextWriter TextWriter TextWriter TextWriter Class

Définition

Représente un writer capable d'écrire une série de caractères séquentiels.Represents a writer that can write a sequential series of characters. Cette classe est abstraite.This class is abstract.

public ref class TextWriter abstract : MarshalByRefObject, IDisposable
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public abstract class TextWriter : MarshalByRefObject, IDisposable
type TextWriter = class
    inherit MarshalByRefObject
    interface IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IDisposable
Héritage
Dérivé
Attributs
Implémente

Exemples

TextWriter est une classe abstraite.The TextWriter class is an abstract class. Par conséquent, vous n’instanciez pas cela dans votre code.Therefore, you do not instantiate it in your code. Le StreamWriter dérive de la classe TextWriter et fournit des implémentations des membres pour l’écriture dans un flux de données.The StreamWriter class derives from TextWriter and provides implementations of the members for writing to a stream. L’exemple suivant montre comment écrire des deux lignes qui se composent de valeurs de chaîne dans un fichier texte à l’aide de la WriteLineAsync(String) (méthode).The following example shows how to write two lines that consist of string values to a text file by using the WriteLineAsync(String) method.

Substituez Dispose dans une classe dérivée pour fournirOverride Dispose in a derived class to provide

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteLineAsync("First line of example");
                await writer.WriteLineAsync("and second line");
            }
        }
    }
}
Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync("First line of example")
            Await writer.WriteLineAsync("and second line")
        End Using
    End Sub
End Module

Remarques

TextWriter est la classe de base abstraite de StreamWriter et StringWriter, qui écrivent des caractères dans les flux et les chaînes, respectivement.TextWriter is the abstract base class of StreamWriter and StringWriter, which write characters to streams and strings, respectively. Créez une instance de TextWriter pour écrire un objet dans une chaîne, écrire des chaînes dans un fichier ou à la sérialisation XML.Create an instance of TextWriter to write an object to a string, write strings to a file, or to serialize XML. Vous pouvez également utiliser une instance de TextWriter pour écrire du texte dans un magasin de stockage personnalisé avec les mêmes API que vous utiliseriez pour une chaîne ou un flux de données, ou pour ajouter la prise en charge de la mise en forme de texte.You can also use an instance of TextWriter to write text to a custom backing store using the same APIs you would use for a string or a stream, or to add support for text formatting.

Tous les Write méthodes de TextWriter ayant des types de données primitifs comme paramètres écrivent les valeurs sous forme de chaînes.All the Write methods of TextWriter having primitive data types as parameters write out the values as strings.

Par défaut, un TextWriter n’est pas thread-safe.By default, a TextWriter is not thread safe. Consultez TextWriter.Synchronized pour un wrapper thread-safe.See TextWriter.Synchronized for a thread-safe wrapper.

Important

Ce type implémente le IDisposable interface.This type implements the IDisposable interface. Lorsque vous avez fini d’utiliser n’importe quel type qui dérive de ce type, vous devez supprimer il directement ou indirectement.When you have finished using any type that derives from this type, you should dispose of it either directly or indirectly. Pour supprimer le type directement, appelez sa Dispose méthode dans un try / catch bloc.To dispose of the type directly, call its Dispose method in a try/catch block. Pour supprimer indirectement, utiliser une construction de langage tel que using (en c#) ou Using (en Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Pour plus d’informations, consultez Dispose et la section « À l’aide un objet qui implémente IDisposable » dans le IDisposable rubrique de l’interface.For more information, see Dispose and the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Pour obtenir la liste des tâches d’e/s courantes, consultez des tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

Notes pour les héritiers

Une classe dérivée doit implémenter au minimum la Write(Char) méthode pour créer une instance utile de TextWriter.A derived class must minimally implement the Write(Char) method to make a useful instance of TextWriter.

Constructeurs

TextWriter() TextWriter() TextWriter() TextWriter()

Initialise une nouvelle instance de la classe TextWriter.Initializes a new instance of the TextWriter class.

TextWriter(IFormatProvider) TextWriter(IFormatProvider) TextWriter(IFormatProvider) TextWriter(IFormatProvider)

Initialise une nouvelle instance de la classe TextWriter avec le fournisseur de format spécifié.Initializes a new instance of the TextWriter class with the specified format provider.

Champs

CoreNewLine CoreNewLine CoreNewLine CoreNewLine

Stocke les caractères de saut de ligne utilisés pour ce TextWriter.Stores the newline characters used for this TextWriter.

Null Null Null Null

Fournit un élément TextWriter sans magasin de stockage dans lequel il est possible d'écrire, mais pas de lire.Provides a TextWriter with no backing store that can be written to, but not read from.

Propriétés

Encoding Encoding Encoding Encoding

En cas de substitution dans une classe dérivée, retourne l'encodage de caractères dans lequel la sortie est écrite.When overridden in a derived class, returns the character encoding in which the output is written.

FormatProvider FormatProvider FormatProvider FormatProvider

Obtient un objet qui contrôle la mise en forme.Gets an object that controls formatting.

NewLine NewLine NewLine NewLine

Obtient ou définit la chaîne de marque de fin de ligne utilisée pour le TextWriter actuel.Gets or sets the line terminator string used by the current TextWriter.

Méthodes

Close() Close() Close() Close()

Ferme le writer actuel et libère toutes les ressources système qui lui sont associées.Closes the current writer and releases any system resources associated with the writer.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libère toutes les ressources utilisées par l'objet TextWriter.Releases all resources used by the TextWriter object.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libère les ressources non managées utilisées par TextWriter et libère éventuellement les ressources managées.Releases the unmanaged resources used by the TextWriter and optionally releases the managed resources.

DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Flush() Flush() Flush() 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.Clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

FlushAsync() FlushAsync() FlushAsync() 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.Asynchronously clears all buffers for the current writer and causes any buffered data to be written to the underlying device.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Synchronized(TextWriter) Synchronized(TextWriter) Synchronized(TextWriter) Synchronized(TextWriter)

Crée un wrapper thread-safe autour du TextWriter spécifié.Creates a thread-safe wrapper around the specified TextWriter.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)
Write(Boolean) Write(Boolean) Write(Boolean) Write(Boolean)

Écrit la représentation textuelle d'une valeur Boolean dans la chaîne ou le flux de texte.Writes the text representation of a Boolean value to the text string or stream.

Write(Char) Write(Char) Write(Char) Write(Char)

Écrit un caractère dans la chaîne ou le flux de texte.Writes a character to the text string or stream.

Write(Char[]) Write(Char[]) Write(Char[]) Write(Char[])

Écrit un tableau de caractères dans la chaîne ou le flux de texte.Writes a character array to the text string or stream.

Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

Écrit un sous-tableau de caractères dans la chaîne ou le flux de texte.Writes a subarray of characters to the text string or stream.

Write(Decimal) Write(Decimal) Write(Decimal) Write(Decimal)

Écrit la représentation textuelle d'une valeur décimale dans la chaîne ou le flux de texte.Writes the text representation of a decimal value to the text string or stream.

Write(Double) Write(Double) Write(Double) Write(Double)

Écrit la représentation textuelle d'une valeur à virgule flottante de 8 octets dans la chaîne ou le flux de texte.Writes the text representation of an 8-byte floating-point value to the text string or stream.

Write(Int32) Write(Int32) Write(Int32) Write(Int32)

Écrit la représentation textuelle d'un entier signé de 4 octets dans la chaîne ou le flux de texte.Writes the text representation of a 4-byte signed integer to the text string or stream.

Write(Int64) Write(Int64) Write(Int64) Write(Int64)

Écrit la représentation textuelle d'un entier signé de 8 octets dans la chaîne ou le flux de texte.Writes the text representation of an 8-byte signed integer to the text string or stream.

Write(Object) Write(Object) Write(Object) Write(Object)

Écrit la représentation textuelle d'un objet dans la chaîne ou le flux de texte en appelant la méthode ToString sur cet objet.Writes the text representation of an object to the text string or stream by calling the ToString method on that object.

Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)
Write(Single) Write(Single) Write(Single) Write(Single)

Écrit la représentation textuelle d'une valeur à virgule flottante de 4 octets dans la chaîne ou le flux de texte.Writes the text representation of a 4-byte floating-point value to the text string or stream.

Write(String) Write(String) Write(String) Write(String)

Écrit une chaîne dans la chaîne ou le flux de texte.Writes a string to the text string or stream.

Write(String, Object) Write(String, Object) Write(String, Object) Write(String, Object)

Écrit une chaîne mise en forme dans la chaîne ou le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object).Writes a formatted string to the text string or stream, using the same semantics as the Format(String, Object) method.

Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object)

Écrit une chaîne mise en forme dans la chaîne ou le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object, Object).Writes a formatted string to the text string or stream, using the same semantics as the Format(String, Object, Object) method.

Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object)

Écrit une chaîne mise en forme dans la chaîne ou le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object, Object, Object).Writes a formatted string to the text string or stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(String, Object[]) Write(String, Object[]) Write(String, Object[]) Write(String, Object[])

Écrit une chaîne mise en forme dans la chaîne ou le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object[]).Writes a formatted string to the text string or stream, using the same semantics as the Format(String, Object[]) method.

Write(StringBuilder) Write(StringBuilder) Write(StringBuilder) Write(StringBuilder)
Write(UInt32) Write(UInt32) Write(UInt32) Write(UInt32)

Écrit la représentation textuelle d'un entier non signé de 4 octets dans la chaîne ou le flux de texte.Writes the text representation of a 4-byte unsigned integer to the text string or stream.

Write(UInt64) Write(UInt64) Write(UInt64) Write(UInt64)

Écrit la représentation textuelle d'un entier non signé de 8 octets dans la chaîne ou le flux de texte.Writes the text representation of an 8-byte unsigned integer to the text string or stream.

WriteAsync(Char) WriteAsync(Char) WriteAsync(Char) WriteAsync(Char)

Écrit un caractère de façon asynchrone dans la chaîne ou le flux de texte.Writes a character to the text string or stream asynchronously.

WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[]) WriteAsync(Char[])

Écrit un tableau de caractères de façon asynchrone dans la chaîne ou le flux de texte.Writes a character array to the text string or stream asynchronously.

WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32) WriteAsync(Char[], Int32, Int32)

Écrit un sous-tableau de caractères de façon asynchrone dans la chaîne ou le flux de texte.Writes a subarray of characters to the text string or stream asynchronously.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken) WriteAsync(ReadOnlyMemory<Char>, CancellationToken)
WriteAsync(String) WriteAsync(String) WriteAsync(String) WriteAsync(String)

Écrit une chaîne de façon asynchrone dans la chaîne ou le flux de texte.Writes a string to the text string or stream asynchronously.

WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken) WriteAsync(StringBuilder, CancellationToken)
WriteLine() WriteLine() WriteLine() WriteLine()

Écrit une marque de fin de ligne dans la chaîne ou le flux de texte.Writes a line terminator to the text string or stream.

WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean)

Écrit la représentation textuelle d'une valeur Boolean suivie d'une marque de fin de ligne dans la chaîne ou le flux de texte.Writes the text representation of a Boolean value followed by a line terminator to the text string or stream.

WriteLine(Char) WriteLine(Char) WriteLine(Char) WriteLine(Char)

Écrit un caractère suivi d'une marque de fin de ligne dans la chaîne ou le flux de texte.Writes a character followed by a line terminator to the text string or stream.

WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[])

Écrit un tableau de caractères suivi d'une marque de fin de ligne dans la chaîne ou le flux de texte.Writes an array of characters followed by a line terminator to the text string or stream.

WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32)

Écrit un sous-tableau de caractères suivi d'une marque de fin de ligne dans la chaîne ou le flux de texte.Writes a subarray of characters followed by a line terminator to the text string or stream.

WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal)

Écrit la représentation textuelle d'une valeur décimale suivie d'une marque de fin de ligne dans la chaîne ou le flux de texte.Writes the text representation of a decimal value followed by a line terminator to the text string or stream.

WriteLine(Double) WriteLine(Double) WriteLine(Double) WriteLine(Double)

Écrit la représentation textuelle d'une valeur à virgule flottante de 8 octets suivie d'une marque de fin de ligne dans la chaîne ou le flux de texte.Writes the text representation of a 8-byte floating-point value followed by a line terminator to the text string or stream.

WriteLine(Int32) WriteLine(Int32) WriteLine(Int32) WriteLine(Int32)

Écrit la représentation textuelle d'un entier signé de 4 octets suivie d'une marque de fin de ligne dans la chaîne ou le flux de texte.Writes the text representation of a 4-byte signed integer followed by a line terminator to the text string or stream.

WriteLine(Int64) WriteLine(Int64) WriteLine(Int64) WriteLine(Int64)

Écrit la représentation textuelle d'un entier signé de 8 octets suivi d'une marque de fin de ligne dans la chaîne ou le flux de texte.Writes the text representation of an 8-byte signed integer followed by a line terminator to the text string or stream.

WriteLine(Object) WriteLine(Object) WriteLine(Object) WriteLine(Object)

Écrit la représentation textuelle d'un objet en appelant la méthode ToString sur cet objet, suivie d'une marque de fin de ligne dans la chaîne ou le flux de texte.Writes the text representation of an object by calling the ToString method on that object, followed by a line terminator to the text string or stream.

WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>)
WriteLine(Single) WriteLine(Single) WriteLine(Single) WriteLine(Single)

Écrit la représentation textuelle d'une valeur à virgule flottante de 4 octets suivie d'une marque de fin de ligne dans la chaîne ou le flux de texte.Writes the text representation of a 4-byte floating-point value followed by a line terminator to the text string or stream.

WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

Écrit une chaîne suivie d'une marque de fin de ligne dans la chaîne ou le flux de texte.Writes a string followed by a line terminator to the text string or stream.

WriteLine(String, Object) WriteLine(String, Object) WriteLine(String, Object) WriteLine(String, Object)

Écrit une chaîne mise en forme et une nouvelle ligne dans la chaîne ou le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object).Writes a formatted string and a new line to the text string or stream, using the same semantics as the Format(String, Object) method.

WriteLine(String, Object, Object) WriteLine(String, Object, Object) WriteLine(String, Object, Object) WriteLine(String, Object, Object)

Écrit une chaîne mise en forme et une nouvelle ligne dans la chaîne ou le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object, Object).Writes a formatted string and a new line to the text string or stream, using the same semantics as the Format(String, Object, Object) method.

WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object) WriteLine(String, Object, Object, Object)

Écrit une chaîne mise en forme et une nouvelle ligne, en utilisant la même sémantique que Format(String, Object).Writes out a formatted string and a new line, using the same semantics as Format(String, Object).

WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[])

Écrit une chaîne mise en forme et une nouvelle ligne, en utilisant la même sémantique que Format(String, Object).Writes out a formatted string and a new line, using the same semantics as Format(String, Object).

WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder)
WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32)

Écrit la représentation textuelle d'un entier non signé de 4 octets suivie d'une marque de fin de ligne dans la chaîne ou le flux de texte.Writes the text representation of a 4-byte unsigned integer followed by a line terminator to the text string or stream.

WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64)

Écrit la représentation textuelle d'un entier non signé de 8 octets suivi d'une marque de fin de ligne dans la chaîne ou le flux de texte.Writes the text representation of an 8-byte unsigned integer followed by a line terminator to the text string or stream.

WriteLineAsync() WriteLineAsync() WriteLineAsync() WriteLineAsync()

Écrit une marque de fin de ligne de façon asynchrone dans la chaîne ou le flux de texte.Writes a line terminator asynchronously to the text string or stream.

WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char)

Écrit un caractère suivi d'une marque de fin de ligne de façon asynchrone dans la chaîne ou le flux de texte.Writes a character followed by a line terminator asynchronously to the text string or stream.

WriteLineAsync(Char[]) WriteLineAsync(Char[]) WriteLineAsync(Char[]) WriteLineAsync(Char[])

Écrit un tableau de caractères suivi d'une marque de fin de ligne de façon asynchrone dans la chaîne ou le flux de texte.Writes an array of characters followed by a line terminator asynchronously to the text string or stream.

WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32)

Écrit un sous-tableau de caractères suivi d'une marque de fin de ligne de façon asynchrone dans la chaîne ou le flux de texte.Writes a subarray of characters followed by a line terminator asynchronously to the text string or stream.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)
WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String)

Écrit une chaîne suivie d'une marque de fin de ligne de façon asynchrone dans la chaîne ou le flux de texte.Writes a string followed by a line terminator asynchronously to the text string or stream.

WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken) WriteLineAsync(StringBuilder, CancellationToken)

Implémentations d’interfaces explicites

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Pour obtenir une description de ce membre, consultez Dispose().For a description of this member, see Dispose().

S’applique à

Voir aussi