StreamWriter.Write Méthode

Définition

Écrit des données dans le flux.

Surcharges

Write(String, Object, Object, Object)

Écrit une chaîne mise en forme dans le flux, en utilisant la même sémantique que la méthode Format(String, Object, Object, Object).

Write(String, Object, Object)

Écrit une chaîne mise en forme dans le flux à l’aide de la même sémantique que la Format(String, Object, Object) méthode.

Write(Char[], Int32, Int32)

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

Write(String, Object[])

Écrit une chaîne mise en forme dans le flux, en utilisant la même sémantique que la méthode Format(String, Object[]).

Write(Char[])

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

Write(String)

Écrit une chaîne dans le flux.

Write(ReadOnlySpan<Char>)

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

Write(Char)

Écrit un caractère dans le flux.

Write(String, Object)

Écrit une chaîne mise en forme dans le flux, en utilisant la même sémantique que la méthode Format(String, Object).

Write(String, Object, Object, Object)

Écrit une chaîne mise en forme dans le flux, en utilisant la même sémantique que la méthode Format(String, Object, Object, Object).

public:
 override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public override void Write (string format, object? arg0, object? arg1, object? arg2);
override this.Write : string * obj * obj * obj -> unit
Public Overrides Sub Write (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

Paramètres

format
String

Chaîne de format composite.

arg0
Object

Premier objet à mettre en forme et à écrire.

arg1
Object

Deuxième objet à mettre en forme et à écrire.

arg2
Object

Troisième objet à mettre en forme et à écrire.

Remarques

Write(String, Object, Object, Object)Pour obtenir une description des fonctionnalités de mise en forme composite proposées, consultez.

S’applique à

Write(String, Object, Object)

Écrit une chaîne mise en forme dans le flux à l’aide de la même sémantique que la Format(String, Object, Object) méthode.

public:
 override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public override void Write (string format, object? arg0, object? arg1);
override this.Write : string * obj * obj -> unit
Public Overrides Sub Write (format As String, arg0 As Object, arg1 As Object)

Paramètres

format
String

Chaîne de format composite.

arg0
Object

Premier objet à mettre en forme et à écrire.

arg1
Object

Deuxième objet à mettre en forme et à écrire.

Remarques

Write(String, Object, Object)Pour obtenir une description des fonctionnalités de mise en forme composite proposées, consultez.

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 contenant les données à écrire.

index
Int32

Position du caractère dans la mémoire tampon où la lecture des données.

count
Int32

Nombre maximal de caractères à écrire.

Exceptions

buffer a la valeur null.

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

index ou count est un nombre négatif.

Une erreur d’E/S se produit.

AutoFlush a la valeur true ou la mémoire tampon de StreamWriter est saturée, et le writer actuel est fermé.

AutoFlush a la valeur true ou la mémoire tampon de StreamWriter est saturée, et le contenu de la mémoire tampon ne peut pas être écrit dans le flux de taille fixe sous-jacent, car StreamWriter se trouve à 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 namespace System;
using namespace System::IO;

int main()
{
   FileStream^ sb = gcnew FileStream( "MyFile.txt",FileMode::OpenOrCreate );
   array<Char>^b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
   StreamWriter^ sw = gcnew StreamWriter( sb );
   sw->Write( b, 3, 8 );
   sw->Close();
}
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 de la index continuation jusqu’à 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 est true .

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

Voir aussi

S’applique à

Write(String, Object[])

Écrit une chaîne mise en forme dans le flux, en utilisant la même sémantique que la méthode Format(String, Object[]).

public:
 override void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public override void Write (string format, params object?[] arg);
override this.Write : string * obj[] -> unit
Public Overrides Sub Write (format As String, ParamArray arg As Object())

Paramètres

format
String

Chaîne de format composite.

arg
Object[]

Tableau d'objets contenant aucun, un ou plusieurs objets à mettre en forme et à écrire.

Remarques

Write(String, Object[])Pour obtenir une description des fonctionnalités de mise en forme composite proposées, consultez.

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);
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 a la valeur null, rien n'est écrit.

Exceptions

Une erreur d’E/S se produit.

AutoFlush a la valeur true ou la mémoire tampon de StreamWriter est saturée, et le writer actuel est fermé.

AutoFlush a la valeur true ou la mémoire tampon de StreamWriter est saturée, et le contenu de la mémoire tampon ne peut pas être écrit dans le flux de taille fixe sous-jacent, car StreamWriter se trouve à 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 est true , 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(String)

Écrit une chaîne dans le flux.

public:
 override void Write(System::String ^ value);
public override void Write (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 a la valeur null, rien n'est écrit.

Exceptions

AutoFlush a la valeur true ou la mémoire tampon de StreamWriter est saturée, et le writer actuel est fermé.

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

Une erreur d’E/S se produit.

Remarques

Cette méthode se substitue à TextWriter.Write.

Le 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 est true . Si value est null , aucune entrée n’est écrite.

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 plage 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>

Plage de caractères à écrire.

S’applique à

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

Une erreur d’E/S se produit.

AutoFlush a la valeur true ou la mémoire tampon de StreamWriter est saturée, et le writer actuel est fermé.

AutoFlush a la valeur true ou la mémoire tampon de StreamWriter est saturée, et le contenu de la mémoire tampon ne peut pas être écrit dans le flux de taille fixe sous-jacent, car StreamWriter se trouve à 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 est true , 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(String, Object)

Écrit une chaîne mise en forme dans le flux, en utilisant la même sémantique que la méthode Format(String, Object).

public:
 override void Write(System::String ^ format, System::Object ^ arg0);
public override void Write (string format, object? arg0);
override this.Write : string * obj -> unit
Public Overrides Sub Write (format As String, arg0 As Object)

Paramètres

format
String

Chaîne de format composite.

arg0
Object

Objet à mettre en forme et à écrire.

Remarques

Write(String, Object)Pour obtenir une description des fonctionnalités de mise en forme composite proposées, consultez.

S’applique à