TextWriter Classe

Définition

Représente un writer capable d'écrire une série de caractères séquentiels. Cette classe est abstraite.

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

Exemples

La classe TextWriter est une classe abstraite. Par conséquent, vous ne l’instanciez pas dans votre code. La StreamWriter classe dérive de TextWriter et fournit des implémentations des membres pour l’écriture dans un flux. L’exemple suivant montre comment écrire deux lignes qui se composent de valeurs de chaîne dans un fichier texte à l’aide de la WriteLineAsync(String) méthode.

Substituez dispose dans une classe dérivée pour fournir

using System.IO;

namespace ConsoleApplication
{
    class Program4
    {
        static void Main()
        {
            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 écrit des caractères dans des flux et des chaînes, respectivement. 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. 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.

Toutes les Write méthodes permettant d' TextWriter avoir des types de données primitifs en tant que paramètres écrivent les valeurs sous forme de chaînes.

Par défaut, un TextWriter n’est pas thread-safe. Consultez TextWriter.Synchronized pour obtenir un wrapper thread-safe.

Important

Ce type implémente l'interface IDisposable. Une fois que vous avez fini d’utiliser un type qui dérive de ce type, vous devez le supprimer directement ou indirectement. Pour supprimer directement le type Dispose, appelez sa méthode dans un bloc try/catch. Pour la supprimer indirectement, utilisez une construction de langage telle que using (dans C#) ou Using (dans Visual Basic). Pour plus d’informations, consultez dispose et la section « utilisation d’un objet qui implémente IDisposable » dans la rubrique de l' IDisposable interface.

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.

Notes pour les responsables de l’implémentation

Une classe dérivée doit implémenter au minimum la Write(Char) méthode pour créer une instance utile de TextWriter .

Constructeurs

TextWriter()

Initialise une nouvelle instance de la classe TextWriter.

TextWriter(IFormatProvider)

Initialise une nouvelle instance de la classe TextWriter avec le fournisseur de format spécifié.

Champs

CoreNewLine

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

Null

Fournit un élément TextWriter sans magasin de stockage dans lequel il est possible d'écrire, mais pas de lire.

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.

FormatProvider

Obtient un objet qui contrôle la mise en forme.

NewLine

Obtient ou définit la chaîne de marque de fin de ligne utilisée pour le TextWriter actuel.

Méthodes

Close()

Ferme le writer actuel et libère toutes les ressources système qui lui sont associées.

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.

Dispose(Boolean)

Libère les ressources non managées utilisées par TextWriter et libère éventuellement les ressources managées.

DisposeAsync()

Libère de façon asynchrone toutes les ressources utilisées par l’objet 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.

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.

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

Crée un wrapper thread-safe autour du TextWriter spécifié.

ToString()

Retourne une chaîne qui représente l'objet actuel.

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

Écrit la représentation sous forme de texte d’une valeur Boolean dans le flux de texte.

Write(Char)

Écrit un caractère dans le flux de texte.

Write(Char[])

Écrit un tableau de caractères dans le flux de texte.

Write(Char[], Int32, Int32)

Écrit un sous-tableau de caractères dans le flux de texte.

Write(Decimal)

Écrit la représentation sous forme de texte d’une valeur décimale dans le flux de texte.

Write(Double)

Écrit la représentation sous forme de texte d’une valeur à virgule flottante de 8 octets dans le flux de texte.

Write(Int32)

Écrit la représentation sous forme de texte d’un entier signé de 4 octets dans le flux de texte.

Write(Int64)

Écrit la représentation sous forme de texte d’un entier signé de 8 octets dans le flux de texte.

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.

Write(ReadOnlySpan<Char>)

Écrit une plage de caractères dans le flux de texte.

Write(Single)

Écrit la représentation sous forme de texte d’une valeur à virgule flottante de 4 octets dans le flux de texte.

Write(String)

Écrit une chaîne dans le flux de texte.

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

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

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

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[]).

Write(StringBuilder)

Écrit un générateur de chaîne dans le flux de texte.

Write(UInt32)

Écrit la représentation sous forme de texte d’un entier non signé de 4 octets dans le flux de texte.

Write(UInt64)

Écrit la représentation sous forme de texte d’un entier non signé de 8 octets dans le flux de texte.

WriteAsync(Char)

Écrit de façon asynchrone un caractère dans le flux de texte.

WriteAsync(Char[])

Écrit de façon asynchrone un tableau de caractères dans le flux de texte.

WriteAsync(Char[], Int32, Int32)

Écrit de façon asynchrone un sous-tableau de caractères dans le flux de texte.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Écrit de façon asynchrone une zone de mémoire de caractères dans le flux de texte.

WriteAsync(String)

Écrit de façon asynchrone une chaîne dans le flux de texte.

WriteAsync(StringBuilder, CancellationToken)

Écrit de façon asynchrone un générateur de chaîne dans le flux de texte.

WriteLine()

Écrit une marque de fin de ligne dans le flux de texte.

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.

WriteLine(Char)

Écrit un caractère dans le flux de texte, suivi d’une marque de fin de ligne.

WriteLine(Char[])

Écrit un tableau de caractères suivi d’une marque de fin de ligne dans le flux de texte.

WriteLine(Char[], Int32, Int32)

Écrit un sous-tableau de caractères dans le flux de texte, suivi d’une marque de fin de ligne.

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.

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.

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.

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.

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.

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.

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.

WriteLine(String)

Écrit une chaîne suivie d’une marque de fin de ligne dans le flux de texte.

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

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

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

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

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.

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.

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.

WriteLineAsync()

Écrit de façon asynchrone une marque de fin de ligne dans le flux de texte.

WriteLineAsync(Char)

Écrit de façon asynchrone un caractère dans le flux de texte, suivi d’une marque de fin de ligne.

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.

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.

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.

WriteLineAsync(String)

Écrit de façon asynchrone une chaîne dans le flux de texte, 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.

Implémentations d’interfaces explicites

IDisposable.Dispose()

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

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 à

Voir aussi