Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

TextWriter classe

 

Date de publication : novembre 2016

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

Espace de noms:   System.IO
Assembly:  mscorlib (dans mscorlib.dll)


[SerializableAttribute]
[ComVisibleAttribute(true)]
public abstract class TextWriter : MarshalByRefObject, IDisposable

NomDescription
System_CAPS_protmethodTextWriter()

Initialise une nouvelle instance de la classe TextWriter.

System_CAPS_protmethodTextWriter(IFormatProvider)

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

NomDescription
System_CAPS_pubpropertyEncoding

En cas de substitution dans une classe dérivée, retourne l'encodage de caractères dans lequel la sortie est écrite.

System_CAPS_pubpropertyFormatProvider

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

System_CAPS_pubpropertyNewLine

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

NomDescription
System_CAPS_pubmethodClose()

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

System_CAPS_pubmethodCreateObjRef(Type)

Crée un objet qui contient toutes les informations requises pour générer un proxy permettant de communiquer avec un objet distant.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodDispose()

Libère toutes les ressources utilisées par l'objet TextWriter.

System_CAPS_protmethodDispose(Boolean)

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

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodFlush()

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.

System_CAPS_pubmethodFlushAsync()

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.

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetLifetimeService()

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

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodInitializeLifetimeService()

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

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Crée une copie superficielle de l’utilisateur actuel MarshalByRefObject objet.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodSystem_CAPS_staticSynchronized(TextWriter)

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

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodWrite(Boolean)

Écrit la représentation textuelle d'une valeur Boolean dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWrite(Char)

Écrit un caractère dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWrite(Char[])

Écrit un tableau de caractères dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWrite(Char[], Int32, Int32)

Écrit un sous-tableau de caractères dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWrite(Decimal)

Écrit la représentation textuelle d'une valeur décimale dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWrite(Double)

Écrit la représentation textuelle d'une valeur à virgule flottante de 8 octets dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWrite(Int32)

Écrit la représentation textuelle d'un entier signé de 4 octets dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWrite(Int64)

Écrit la représentation textuelle d'un entier signé de 8 octets dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWrite(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.

System_CAPS_pubmethodWrite(Single)

Écrit la représentation textuelle d'une valeur à virgule flottante de 4 octets dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWrite(String)

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

System_CAPS_pubmethodWrite(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 String.Format(String, Object).

System_CAPS_pubmethodWrite(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 String.Format(String, Object, Object).

System_CAPS_pubmethodWrite(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 String.Format(String, Object, Object, Object).

System_CAPS_pubmethodWrite(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 String.Format(String, Object[]).

System_CAPS_pubmethodWrite(UInt32)

Écrit la représentation textuelle d'un entier non signé de 4 octets dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWrite(UInt64)

Écrit la représentation textuelle d'un entier non signé de 8 octets dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWriteAsync(Char)

Écrit un caractère de façon asynchrone dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWriteAsync(Char[])

Écrit un tableau de caractères de façon asynchrone dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWriteAsync(Char[], Int32, Int32)

Écrit un sous-tableau de caractères de façon asynchrone dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWriteAsync(String)

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

System_CAPS_pubmethodWriteLine()

Écrit une marque de fin de ligne dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLine(Char)

Écrit un caractère suivi d'une marque de fin de ligne dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWriteLine(Char[])

Écrit un tableau de caractères suivi d'une marque de fin de ligne dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLine(String)

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

System_CAPS_pubmethodWriteLine(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 String.Format(String, Object).

System_CAPS_pubmethodWriteLine(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 String.Format(String, Object, Object).

System_CAPS_pubmethodWriteLine(String, Object, Object, Object)

Écrit une chaîne mise en forme et une nouvelle ligne, en utilisant la même sémantique que Format.

System_CAPS_pubmethodWriteLine(String, Object[])

Écrit une chaîne mise en forme et une nouvelle ligne, en utilisant la même sémantique que Format.

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLineAsync()

Écrit une marque de fin de ligne de façon asynchrone dans la chaîne ou le flux de texte.

System_CAPS_pubmethodWriteLineAsync(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.

System_CAPS_pubmethodWriteLineAsync(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.

System_CAPS_pubmethodWriteLineAsync(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.

System_CAPS_pubmethodWriteLineAsync(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.

NomDescription
System_CAPS_protfieldCoreNewLine

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

System_CAPS_pubfieldSystem_CAPS_staticNull

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

TextWriter est la classe de base abstraite StreamWriter et StringWriter, qui écrivent des caractères dans les flux et les 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 à la sérialisation XML. Vous pouvez également utiliser une instance de TextWriter pour écrire du texte dans un magasin de sauvegarde personnalisé en utilisant les mêmes API que vous utiliseriez pour une chaîne ou un flux ou pour ajouter la prise en charge de la mise en forme du texte.

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.

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

System_CAPS_importantImportant

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

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

Remarques à l’attention des héritiers :

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

TextWriter est une classe abstraite. Par conséquent, vous n’instanciez pas cela dans votre 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. L’exemple suivant montre comment écrire deux lignes comportant des 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;
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");
            }
        }
    }
}

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: