Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

TextWriter, classe

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

Le type TextWriter expose les membres suivants.

  NomDescription
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTextWriter()Initialise une nouvelle instance de la classe TextWriter.
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTextWriter(IFormatProvider)Initialise une nouvelle instance de la classe TextWriter avec le fournisseur de formats spécifié.
Début

  NomDescription
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEncodingEn cas de substitution dans une classe dérivée, retourne l'encodage de caractère dans lequel la sortie est écrite.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFormatProviderObtient un objet qui contrôle la mise en forme.
Propriété publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreNewLineObtient ou définit la chaîne de terminaison de ligne utilisée pour le TextWriter en cours.
Début

  NomDescription
Méthode publiquePris en charge par XNA FrameworkCloseFerme le writer actuel et libère toutes les ressources système qui lui sont associées.
Méthode publiqueCreateObjRefCré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.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDispose()Libère toutes les ressources utilisées par l'objet TextWriter.
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreDispose(Boolean)Libère les ressources non managées utilisées par TextWriter et libère éventuellement les ressources managées.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFinalize 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.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFlushEfface toutes les mémoires tampons pour le writer actuel et provoque l'écriture des données mises en mémoire tampon sur le périphérique sous-jacent.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreFlushAsyncEfface 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 le périphérique sous-jacent.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetLifetimeServiceRé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.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueInitializeLifetimeServiceObtient 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.)
Méthode protégéePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMemberwiseClone()Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégéeMemberwiseClone(Boolean)Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject.)
Méthode publiqueMembre statiquePris en charge par XNA FrameworkSynchronizedCrée un wrapper thread-safe autour du TextWriter spécifié.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWrite(Boolean)Écrit la représentation textuelle d'une valeur Boolean dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWrite(Char)Écrit un caractère dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWrite(Char[])Écrit un tableau de caractères dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWrite(Decimal)Écrit la représentation textuelle d'une valeur décimale dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWrite(Double)Écrit la représentation textuelle d'une valeur à virgule flottante de 8 octets dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWrite(Int32)Écrit la représentation textuelle d'un entier signé de 4 octets dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWrite(Int64)Écrit la représentation textuelle d'un entier signé de 8 octets dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWrite(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.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWrite(Single)Écrit la représentation textuelle d'une valeur à virgule flottante de 4 octets dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWrite(String)Écrit une chaîne dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWrite(UInt32)Écrit la représentation textuelle d'un entier non-signé de 4 octets dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWrite(UInt64)Écrit la représentation textuelle d'un entier non-signé de 8 octets dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkWrite(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).
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWrite(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[]).
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWrite(Char[], Int32, Int32)Écrit un sous-tableau de caractères dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkWrite(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).
Méthode publiqueWrite(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).
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteAsync(Char)Écrit un caractère dans la chaîne ou le flux de texte de façon asynchrone.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteAsync(Char[])Écrit un tableau de caractères dans la chaîne ou le flux de texte de façon asynchrone.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteAsync(String)Écrit une chaîne dans la chaîne ou le flux de texte de façon asynchrone.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteAsync(Char[], Int32, Int32)Écrit un sous-tableau de caractères dans la chaîne ou le flux de texte de façon asynchrone.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine()Écrit dans la chaîne ou le flux de texte un terminateur de ligne.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine(Boolean)Écrit la représentation textuelle d'une valeur Boolean suivie d'un terminateur de ligne dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine(Char)Écrit dans la chaîne ou le flux de texte un caractère suivi d'un terminateur de ligne.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine(Char[])Écrit un tableau de caractères suivi d'un terminateur de ligne dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine(Decimal)Écrit la représentation textuelle d'une valeur décimale suivie d'un terminateur de ligne dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine(Double)Écrit la représentation textuelle d'une valeur à virgule flottante de 8 octets suivie d'un terminateur de ligne dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine(Int32)Écrit la représentation textuelle d'un entier signé de 4 octets suivie d'un terminateur de ligne dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine(Int64)Écrit la représentation textuelle d'un entier signé de 8 octets suivi d'un terminateur de ligne dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine(Object)Écrit la représentation textuelle d'un objet en appelant la méthode ToString sur cet objet, suivie d'un terminateur de ligne dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine(Single)Écrit la représentation textuelle d'une valeur à virgule flottante de 4 octets suivie d'un terminateur de ligne dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine(String)Écrit une chaîne suivie d'un terminateur de ligne dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine(UInt32)Écrit la représentation textuelle d'un entier non-signé de 4 octets suivie d'un terminateur de ligne dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine(UInt64)Écrit la représentation textuelle d'un entier non-signé de 8 octets suivi d'un terminateur de ligne dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkWriteLine(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).
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine(String, Object[])Écrit une chaîne mise en forme et une nouvelle ligne, en utilisant la même sémantique que Format.
Méthode publiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreWriteLine(Char[], Int32, Int32)Écrit un sous-tableau de caractères suivi d'un terminateur de ligne dans la chaîne ou le flux de texte.
Méthode publiquePris en charge par XNA FrameworkWriteLine(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).
Méthode publiqueWriteLine(String, Object, Object, Object)Écrit une chaîne mise en forme et une nouvelle ligne, en utilisant la même sémantique que Format.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteLineAsync()Écrit dans la chaîne ou le flux de texte un terminateur de ligne de façon asynchrone.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteLineAsync(Char)Écrit dans la chaîne ou le flux de texte un caractère suivi d'un terminateur de ligne de façon asynchrone.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteLineAsync(Char[])Écrit un tableau de caractères suivi d'un terminateur de ligne de façon asynchrone dans la chaîne ou le flux de texte.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteLineAsync(String)Écrit une chaîne suivie d'un terminateur de ligne de façon asynchrone dans la chaîne ou le flux de texte.
Méthode publiquePris en charge dans .NET pour les applications du Windows StoreWriteLineAsync(Char[], Int32, Int32)Écrit un sous-tableau de caractères suivi d'un terminateur de ligne de façon asynchrone dans la chaîne ou le flux de texte.
Début

  NomDescription
Champ protégéPris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreCoreNewLineStocke les caractères de saut de ligne utilisés pour ce TextWriter.
Champ publicMembre statiquePris en charge par XNA FrameworkPris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreNullFournit un TextWriter sans magasin de sauvegarde dans lequel il est possible d'écrire, mais qu'il est impossible de lire.
Début

TextWriter est la classe de base abstraite de StreamWriter et StringWriter, qui écrivent respectivement des caractères dans les flux et les chaînes. Créez une instance de TextWriter pour écrire un objet dans une chaîne, écrire des chaînes dans un fichier ou sérialiser 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 pour une chaîne ou un flux ou pour ajouter la prise en charge de la mise en forme de texte.

Toutes les méthodes Write de TextWriter possédant des types de données primitifs comme paramètres écrivent les valeurs sous forme de chaînes.

Par défaut, TextWriter n'est pas thread-safe. Consultez TextWriter.Synchronized pour plus d'informations sur un wrapper thread-safe.

Remarque importanteImportant

Ce type implémente l'interface IDisposable. When you have finished using any type that derives from this type, you should dispose of it either directly or indirectly. To dispose of the type directly, call its Dispose method in a try/catch block. Pour le libérer indirectement, utiliser l'instruction using (en C#) ou Using (en Visual Basic). 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.

Remarques à l'attention des héritiers

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

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 écrire dans un flux. L'exemple suivant montre comment écrire deux lignes qui se composent des valeurs de chaîne dans un fichier texte en utilisant la méthode WriteLineAsync(String).

Override 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");
            }
        }
    }
}


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2015 Microsoft