TextWriter Classe

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 ne l’instanciez pas dans votre code.Therefore, you do not instantiate it in your code. La StreamWriter classe dérive de TextWriter et fournit des implémentations des membres pour l’écriture dans un flux.The StreamWriter class derives from TextWriter and provides implementations of the members for writing to a stream. L’exemple suivant montre comment écrire deux lignes qui se composent de valeurs de chaîne dans un fichier texte WriteLineAsync(String) à l’aide de la 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

TextWriterest la classe de base abstraite StringWriterde et, qui écrit des caractères dans des StreamWriter flux et des 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 sérialiser du code 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é à l’aide des mêmes API que celles que vous utiliseriez pour une chaîne ou un flux, ou pour ajouter la prise en charge de la mise en forme du 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.

Toutes les Write méthodes permettant TextWriter d’avoir des types de données primitifs en tant que 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 obtenir un wrapper thread-safe.See TextWriter.Synchronized for a thread-safe wrapper.

Important

Ce type implémente l'interface IDisposable.This type implements the IDisposable interface. Une fois que vous avez fini d’utiliser un type qui dérive de ce type, vous devez le supprimer 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 directement le type Dispose, appelez sa méthode dans un bloc try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Pour la supprimer indirectement, utilisez une construction de langage telle que using (dans C#) ou Using (dans 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 « utilisation d’un objet qui implémente IDisposable » IDisposable dans la 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 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 Write(Char) minimum la méthode pour créer une instance TextWriterutile de.A derived class must minimally implement the Write(Char) method to make a useful instance of TextWriter.

Constructeurs

TextWriter()

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

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

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

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

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

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

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()

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)

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.

(Hérité de MarshalByRefObject)
Dispose()

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

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()

Libère de façon asynchrone toutes les ressources utilisées par l’objet TextWriter.Asynchronously releases all resources used by the TextWriter 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.

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

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()

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

(Hérité de Object)
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.

(Hérité de MarshalByRefObject)
GetType()

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

(Hérité de Object)
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.

(Hérité de MarshalByRefObject)
MemberwiseClone()

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

(Hérité de Object)
MemberwiseClone(Boolean)

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

(Hérité de MarshalByRefObject)
Synchronized(TextWriter)

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

ToString()

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

(Hérité de Object)
Write(Boolean)

Écrit la représentation sous forme de texte d’une valeur Boolean dans le flux de texte.Writes the text representation of a Boolean value to the text stream.

Write(Char)

Écrit un caractère dans le flux de texte.Writes a character to the text stream.

Write(Char[])

Écrit un tableau de caractères dans le flux de texte.Writes a character array to the text stream.

Write(Char[], Int32, Int32)

Écrit un sous-tableau de caractères dans le flux de texte.Writes a subarray of characters to the text stream.

Write(Decimal)

Écrit la représentation sous forme de texte d’une valeur décimale dans le flux de texte.Writes the text representation of a decimal value to the text stream.

Write(Double)

Écrit la représentation sous forme de texte d’une valeur à virgule flottante de 8 octets dans le flux de texte.Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Int32)

Écrit la représentation sous forme de texte d’un entier signé de 4 octets dans le flux de texte.Writes the text representation of a 4-byte signed integer to the text stream.

Write(Int64)

Écrit la représentation sous forme de texte d’un entier signé de 8 octets dans le flux de texte.Writes the text representation of an 8-byte signed integer to the text stream.

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.Writes the text representation of an object to the text stream by calling the ToString method on that object.

Write(ReadOnlySpan<Char>)

Écrit une plage de caractères dans le flux de texte.Writes a character span to the text stream.

Write(Single)

Écrit la représentation sous forme de texte d’une valeur à virgule flottante de 4 octets dans le flux de texte.Writes the text representation of a 4-byte floating-point value to the text stream.

Write(String)

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

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).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object) method.

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).Writes a formatted string to the text stream using the same semantics as the Format(String, Object, Object) method.

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).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object, Object, Object) method.

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[]).Writes a formatted string to the text stream, using the same semantics as the Format(String, Object[]) method.

Write(StringBuilder)

Écrit un générateur de chaîne dans le flux de texte.Writes a string builder to the text stream.

Write(UInt32)

Écrit la représentation sous forme de texte d’un entier non signé de 4 octets dans le flux de texte.Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(UInt64)

Écrit la représentation sous forme de texte d’un entier non signé de 8 octets dans le flux de texte.Writes the text representation of an 8-byte unsigned integer to the text stream.

WriteAsync(Char)

Écrit de façon asynchrone un caractère dans le flux de texte.Writes a character to the text stream asynchronously.

WriteAsync(Char[])

Écrit de façon asynchrone un tableau de caractères dans le flux de texte.Writes a character array to the text stream asynchronously.

WriteAsync(Char[], Int32, Int32)

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

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Écrit de façon asynchrone une zone de mémoire de caractères dans le flux de texte.Asynchronously writes a character memory region to the text stream.

WriteAsync(String)

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

WriteAsync(StringBuilder, CancellationToken)

Écrit de façon asynchrone un générateur de chaîne dans le flux de texte.Asynchronously writes a string builder to the text stream.

WriteLine()

Écrit une marque de fin de ligne dans le flux de texte.Writes a line terminator to the text stream.

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.Writes the text representation of a Boolean value to the text stream, followed by a line terminator.

WriteLine(Char)

Écrit un caractère dans le flux de texte, suivi d’une marque de fin de ligne.Writes a character to the text stream, followed by a line terminator.

WriteLine(Char[])

Écrit un tableau de caractères suivi d’une marque de fin de ligne dans le flux de texte.Writes an array of characters to the text stream, followed by a line terminator.

WriteLine(Char[], Int32, Int32)

Écrit un sous-tableau de caractères dans le flux de texte, suivi d’une marque de fin de ligne.Writes a subarray of characters to the text stream, followed by a line terminator.

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.Writes the text representation of a decimal value to the text stream, followed by a line terminator.

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.Writes the text representation of a 8-byte floating-point value to the text stream, followed by a line terminator.

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.Writes the text representation of a 4-byte signed integer to the text stream, followed by a line terminator.

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.Writes the text representation of an 8-byte signed integer to the text stream, followed by a line terminator.

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.Writes the text representation of an object to the text stream, by calling the ToString method on that object, followed by a line terminator.

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.Writes the text representation of a character span to the text stream, followed by a line terminator.

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.Writes the text representation of a 4-byte floating-point value to the text stream, followed by a line terminator.

WriteLine(String)

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

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).Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object) method.

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).Writes a formatted string and a new line to the text stream, using the same semantics as the Format(String, Object, Object) method.

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).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

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).Writes out a formatted string and a new line to the text stream, using the same semantics as Format(String, Object).

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.Writes the text representation of a string builder to the text stream, followed by a line terminator.

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.Writes the text representation of a 4-byte unsigned integer to the text stream, followed by a line terminator.

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.Writes the text representation of an 8-byte unsigned integer to the text stream, followed by a line terminator.

WriteLineAsync()

Écrit de façon asynchrone une marque de fin de ligne dans le flux de texte.Asynchronously writes a line terminator to the text stream.

WriteLineAsync(Char)

Écrit de façon asynchrone un caractère dans le flux de texte, suivi d’une marque de fin de ligne.Asynchronously writes a character to the text stream, followed by a line terminator.

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.Asynchronously writes an array of characters to the text stream, followed by a line terminator.

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.Asynchronously writes a subarray of characters to the text stream, followed by a line terminator.

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.Asynchronously writes the text representation of a character memory region to the text stream, followed by a line terminator.

WriteLineAsync(String)

Écrit de façon asynchrone une chaîne dans le flux de texte, suivie d’une marque de fin de ligne.Asynchronously writes a string to the text stream, followed by a line terminator.

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.Asynchronously writes the text representation of a string builder to the text stream, followed by a line terminator.

Implémentations d’interfaces explicites

IDisposable.Dispose()

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

S’applique à

Voir aussi