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 à l’aide de 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 méthode Format(String, Object, Object).

Write(Char[], Int32, Int32)

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

Write(String, ReadOnlySpan<Object>)

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

Write(String, Object[])

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

Write(ReadOnlySpan<Char>)

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

Write(String)

Écrit une chaîne dans le flux.

Write(Char[])

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

Write(String, Object, Object, Object)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

Écrit une chaîne mise en forme dans le flux à l’aide de 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

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

S’applique à

Write(String, Object, Object)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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

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

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

S’applique à

Write(Char[], Int32, Int32)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

É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

buffer est null.

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

index ou count est négatif.

Une erreur d’E/S se produit.

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

AutoFlush a la valeur true ou la mémoire tampon StreamWriter est pleine et le contenu de la mémoire tampon ne peut pas être écrit dans le flux de taille fixe sous-jacent, car le 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 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 remplace TextWriter.Write.

Les caractères sont lus à partir de buffer commençant à index et continuant à travers 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ée 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, ReadOnlySpan<Object>)

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

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

Paramètres

format
String

Chaîne de format composite.

arg
ReadOnlySpan<Object>

Étendue d’objet qui contient zéro ou plusieurs objets à mettre en forme et écrire.

S’applique à

Write(String, Object[])

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

Écrit une chaîne mise en forme dans le flux à l’aide de 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 qui contient zéro ou plusieurs objets à mettre en forme et écrire.

Remarques

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

S’applique à

Write(ReadOnlySpan<Char>)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

É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 StreamWriter est pleine et l’enregistreur actuel est fermé.

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

Une erreur d’E/S se produit.

Remarques

Cette méthode remplace TextWriter.Write.

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

Flush est appelée 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(Char[])

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

É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 est null, rien n’est écrit.

Exceptions

Une erreur d’E/S se produit.

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

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

Remarques

Cette méthode remplace 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(Char)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

É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 StreamWriter est pleine et l’enregistreur actuel est fermé.

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

Remarques

Cette méthode remplace 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)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

Écrit une chaîne mise en forme dans le flux à l’aide de 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

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

S’applique à