TextWriter Classe

Définition

Représente un enregistreur capable d’écrire une série séquentielle de caractères. 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 classe StreamWriter 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 méthode WriteLineAsync(String).

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 de StringWriter, qui écrivent des caractères dans des flux et des chaînes, respectivement. Utilisez 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 l’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 méthodes Write de TextWriter ayant des types de données primitifs en tant que paramètres écrivent les valeurs sous forme de chaînes.

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

Important

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

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 méthode Write(Char) pour rendre 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 ligne utilisés pour cette TextWriter.

Null

Fournit une TextWriter sans magasin de stockage qui peut être écrit, mais pas lu à partir de.

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 fin de ligne utilisée par la TextWriteractuelle.

Méthodes

Close()

Ferme l’enregistreur actuel et libère toutes les ressources système associées à l’enregistreur.

CreateBroadcasting(TextWriter[])

Crée une instance de TextWriter qui écrit des entrées fournies dans chacun des enregistreurs de writers.

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.

Dispose(Boolean)

Libère les ressources non managées utilisées par le 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 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.

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.

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

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

ToString()

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

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

Écrit la représentation textuelle 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 textuelle d’une valeur décimale dans le flux de texte.

Write(Double)

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

Write(Int32)

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

Write(Int64)

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

Write(Object)

Écrit la représentation textuelle d’un objet dans le flux de texte en appelant la méthode ToString sur cet objet.

Write(ReadOnlySpan<Char>)

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

Write(Single)

Écrit la représentation textuelle 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 à l’aide de 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 à l’aide de 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 à l’aide de 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 à l’aide de la même sémantique que la méthode Format(String, Object[]).

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

Write(StringBuilder)

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

Write(UInt32)

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

Write(UInt64)

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

WriteAsync(Char)

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

WriteAsync(Char[])

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

WriteAsync(Char[], Int32, Int32)

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

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

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

WriteAsync(String)

Écrit une chaîne dans le flux de texte de manière asynchrone.

WriteAsync(StringBuilder, CancellationToken)

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

WriteLine()

Écrit un terminateur de ligne dans le flux de texte.

WriteLine(Boolean)

Écrit la représentation textuelle 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 dans le flux de texte, suivi d’un terminateur de ligne.

WriteLine(Char[], Int32, Int32)

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

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.

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.

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.

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.

WriteLine(Object)

Écrit la représentation textuelle d’un objet dans le flux de texte, en appelant la méthode ToString sur cet objet, suivie d’un terminateur 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.

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.

WriteLine(String)

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

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 à l’aide de 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 à l’aide de la même sémantique que Format(String, Object).

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

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.

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.

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.

WriteLineAsync()

Écrit de façon asynchrone un terminateur 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 dans le flux de texte, suivi d’une marque de fin 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.

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.

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 textuelle d’un générateur de chaînes 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 jetable asynchrone sont effectuées.

S’applique à

Voir aussi