StreamWriter.Write Méthode

Définition

Espace de noms:
System.IO
Assemblys:
mscorlib.dll, System.IO.dll
Assembly:
mscorlib.dll
Assembly:
System.IO.dll
Assembly:
netstandard.dll

Écrit des données dans le flux.

Surcharges

Nom Description
Write(Char)

Écrit un caractère dans le flux.
Write(Char[])

Écrit un tableau de caractères dans le flux.
Write(ReadOnlySpan<Char>)

Écrit une étendue de caractères dans le flux.
Write(String)

Écrit une chaîne dans le flux.
Write(Char[], Int32, Int32)

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

Write(Char)

Écrit un caractère dans le flux.

public:
 override void Write(char value);
public override void Write(char value);
override this.Write : char -> unit
Public Overrides Sub Write (value As Char)

Paramètres

value
Char

Caractère à écrire dans le flux.

Exceptions

IOException

Une erreur d’E/S se produit.

ObjectDisposedException

AutoFlush a la valeur true ou la mémoire tampon est pleine et l’enregistreur StreamWriter actuel est fermé.

NotSupportedException

AutoFlush a la valeur true ou la StreamWriter mémoire tampon est pleine et le contenu de la mémoire tampon ne peut pas être écrit dans le flux de taille fixe sous-jacent, car il StreamWriter est à la fin du flux.

Remarques

Cette méthode se substitue à TextWriter.Write.

Le caractère spécifié est écrit dans le flux sous-jacent, sauf si la fin du flux est atteinte prématurément. Si AutoFlush c’est truele cas, Flush est appelé automatiquement.

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

Voir aussi

S’applique à

Write(Char[])

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

public:
 override void Write(cli::array <char> ^ buffer);
public override void Write(char[] buffer);
override this.Write : char[] -> unit
Public Overrides Sub Write (buffer As Char())

Paramètres

buffer
Char[]

Tableau de caractères contenant les données à écrire. Si buffer c’est nullle cas, rien n’est écrit.

Exceptions

IOException

Une erreur d’E/S se produit.

ObjectDisposedException

AutoFlush a la valeur true ou la mémoire tampon est pleine et l’enregistreur StreamWriter actuel est fermé.

NotSupportedException

AutoFlush a la valeur true ou la StreamWriter mémoire tampon est pleine et le contenu de la mémoire tampon ne peut pas être écrit dans le flux de taille fixe sous-jacent, car il StreamWriter est à la fin du flux.

Remarques

Cette méthode se substitue à TextWriter.Write.

Les caractères spécifiés sont écrits dans le flux sous-jacent, sauf si la fin du flux est atteinte prématurément. Si AutoFlush c’est truele cas, Flush est appelé automatiquement.

Cette méthode peut fournir des performances plus rapides que Write (char[],``int,``int) car elle a moins d’arguments à vérifier.

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

Voir aussi

S’applique à

Write(ReadOnlySpan<Char>)

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

public:
 override void Write(ReadOnlySpan<char> buffer);
public override void Write(ReadOnlySpan<char> buffer);
override this.Write : ReadOnlySpan<char> -> unit
Public Overrides Sub Write (buffer As ReadOnlySpan(Of Char))

Paramètres

buffer
ReadOnlySpan<Char>

Étendue de caractères à écrire.

S’applique à

Write(String)

Écrit une chaîne dans le flux.

public:
 override void Write(System::String ^ value);
public override void Write(string value);
override this.Write : string -> unit
Public Overrides Sub Write (value As String)

Paramètres

value
String

Chaîne à écrire dans le flux. Si value la valeur est null, rien n’est écrit.

Exceptions

ObjectDisposedException

AutoFlush a la valeur true ou la mémoire tampon est pleine et l’enregistreur StreamWriter actuel est fermé.

NotSupportedException

AutoFlush a la valeur true ou la StreamWriter mémoire tampon est pleine et le contenu de la mémoire tampon ne peut pas être écrit dans le flux de taille fixe sous-jacent, car il StreamWriter est à la fin du flux.

IOException

Une erreur d’E/S se produit.

Remarques

Cette méthode se substitue à TextWriter.Write.

Le flux spécifié String est écrit dans le flux sous-jacent, sauf si la fin du flux est atteinte prématurément.

Flush est appelé automatiquement si AutoFlush c’est true. Si value c’est le cas, aucune entrée n’est nullécrite.

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

Voir aussi

S’applique à

Write(Char[], Int32, Int32)

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

public:
 override void Write(cli::array <char> ^ buffer, int index, int count);
public override void Write(char[] buffer, int index, int count);
override this.Write : char[] * int * int -> unit
Public Overrides Sub Write (buffer As Char(), index As Integer, count As Integer)

Paramètres

buffer
Char[]

Tableau de caractères qui contient les données à écrire.

index
Int32

Position de caractère dans la mémoire tampon à laquelle commencer la lecture des données.

count
Int32

Nombre maximal de caractères à écrire.

Exceptions

ArgumentNullException

buffer a la valeur null.

ArgumentException

La longueur de la mémoire tampon moins index est inférieure à count.

ArgumentOutOfRangeException

index ou count est négatif.

IOException

Une erreur d’E/S se produit.

ObjectDisposedException

AutoFlush a la valeur true ou la mémoire tampon est pleine et l’enregistreur StreamWriter actuel est fermé.

NotSupportedException

AutoFlush a la valeur true ou la StreamWriter mémoire tampon est pleine et le contenu de la mémoire tampon ne peut pas être écrit dans le flux de taille fixe sous-jacent, car il StreamWriter est à la fin du flux.

Exemples

Cet exemple écrit huit caractères d’un tableau de 13 éléments dans un fichier, en commençant par le troisième élément du tableau.

using System;
using System.IO;

public class SWBuff
{
    public static void Main(String[] args)
    {
        FileStream sb = new FileStream("MyFile.txt", FileMode.OpenOrCreate);
        char[] b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
        StreamWriter sw = new StreamWriter(sb);
        sw.Write(b, 3, 8);
        sw.Close();
    }
}

Imports System.IO

Public Class SWBuff

    Public Shared Sub Main()
        Dim sb As New FileStream("MyFile.txt", FileMode.OpenOrCreate)
        Dim b As Char() = {"a"c, "b"c, "c"c, "d"c, "e"c, "f"c, "g"c, _
           "h"c, "i"c, "j"c, "k"c, "l"c, "m"c}
        Dim sw As New StreamWriter(sb)
        sw.Write(b, 3, 8)
        sw.Close()
    End Sub
End Class

Remarques

Cette méthode se substitue à TextWriter.Write.

Les caractères sont lus à partir du buffer début et index continuent à index + (count - 1). Tous les caractères sont écrits dans le flux sous-jacent, sauf si la fin du flux sous-jacent est atteinte prématurément. Flush est appelé automatiquement si AutoFlush c’est true.

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

Voir aussi

S’applique à