StreamWriter.Write Méthode

Définition

Écrit des données dans le flux.Writes data to the stream.

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).Writes a formatted string to the stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(String, 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).Writes a formatted string to the stream using the same semantics as the Format(String, Object, Object) method..

Write(Char[], Int32, Int32)

Écrit un sous-tableau de caractères dans le flux.Writes a subarray of characters to the stream.

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[]).Writes a formatted string to the stream, using the same semantics as the Format(String, Object[]) method.

Write(ReadOnlySpan<Char>)

Écrit une plage de caractères dans le flux.Writes a character span to the stream.

Write(String)

Écrit une chaîne dans le flux.Writes a string to the stream.

Write(Char[])

Écrit un tableau de caractères dans le flux.Writes a character array to the stream.

Write(Char)

Écrit un caractère dans le flux.Writes a character to the stream.

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).Writes a formatted string to the stream, using the same semantics as the Format(String, Object) method.

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).Writes a formatted string to the stream, using the same semantics as the Format(String, Object, Object, Object) method.

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.A composite format string.

arg0
Object

Premier objet à mettre en forme et à écrire.The first object to format and write.

arg1
Object

Deuxième objet à mettre en forme et à écrire.The second object to format and write.

arg2
Object

Troisième objet à mettre en forme et à écrire.The third object to format and write.

Remarques

Write(String, Object, Object, Object)Pour obtenir une description des fonctionnalités de mise en forme composite proposées, consultez.See Write(String, Object, Object, Object) for a description of the composite formatting capabilities offered.

S’applique à

Write(String, 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).Writes a formatted string to the stream using the same semantics as the Format(String, Object, Object) method..

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.A composite format string.

arg0
Object

Premier objet à mettre en forme et à écrire.The first object to format and write.

arg1
Object

Deuxième objet à mettre en forme et à écrire.The second object to format and write.

Remarques

Write(String, Object, Object)Pour obtenir une description des fonctionnalités de mise en forme composite proposées, consultez.See Write(String, Object, Object) for a description of the composite formatting capabilities offered.

S’applique à

Write(Char[], Int32, Int32)

Écrit un sous-tableau de caractères dans le flux.Writes a subarray of characters to the stream.

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.A character array that contains the data to write.

index
Int32

Position du caractère dans la mémoire tampon où la lecture des données.The character position in the buffer at which to start reading data.

count
Int32

Nombre maximal de caractères à écrire.The maximum number of characters to write.

Exceptions

buffer a la valeur null.buffer is null.

La longueur de la mémoire tampon moins index est inférieure à count.The buffer length minus index is less than count.

index ou count est un nombre négatif.index or count is negative.

Une erreur d’E/S se produit.An I/O error occurs.

AutoFlush a la valeur true ou la mémoire tampon de StreamWriter est saturée, et le writer actuel est fermé.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

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.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

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.This example writes eight characters from a 13-element array to a file, beginning at the third element of the array.

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.This method overrides TextWriter.Write.

Les caractères sont lus à partir du buffer début et de la index continuation jusqu’à index + ( count -1).The characters are read from buffer beginning at index and continuing through 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.All characters are written to the underlying stream unless the end of the underlying stream is reached prematurely. Flush est appelé automatiquement si AutoFlush est true .Flush is invoked automatically if AutoFlush is true.

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

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[]).Writes a formatted string to the stream, using the same semantics as the Format(String, Object[]) method.

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.A composite format string.

arg
Object[]

Tableau d'objets contenant aucun, un ou plusieurs objets à mettre en forme et à écrire.An object array that contains zero or more objects to format and write.

Remarques

Write(String, Object[])Pour obtenir une description des fonctionnalités de mise en forme composite proposées, consultez.See Write(String, Object[]) for a description of the composite formatting capabilities offered.

S’applique à

Write(ReadOnlySpan<Char>)

Écrit une plage de caractères dans le flux.Writes a character span to the stream.

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.The character span to write.

S’applique à

Write(String)

Écrit une chaîne dans le flux.Writes a string to the stream.

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.The string to write to the stream. Si value a la valeur null, rien n'est écrit.If value is null, nothing is written.

Exceptions

AutoFlush a la valeur true ou la mémoire tampon de StreamWriter est saturée, et le writer actuel est fermé.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

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.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Une erreur d’E/S se produit.An I/O error occurs.

Remarques

Cette méthode se substitue à TextWriter.Write.This method overrides TextWriter.Write.

Le spécifié String est écrit dans le flux sous-jacent, sauf si la fin du flux est atteinte prématurément.The specified String is written to the underlying stream unless the end of the stream is reached prematurely.

Flush est appelé automatiquement si AutoFlush est true .Flush is invoked automatically if AutoFlush is true. Si value est null , aucune entrée n’est écrite.If value is null, no entries are written.

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

Voir aussi

S’applique à

Write(Char[])

Écrit un tableau de caractères dans le flux.Writes a character array to the stream.

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.A character array containing the data to write. Si buffer a la valeur null, rien n'est écrit.If buffer is null, nothing is written.

Exceptions

Une erreur d’E/S se produit.An I/O error occurs.

AutoFlush a la valeur true ou la mémoire tampon de StreamWriter est saturée, et le writer actuel est fermé.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

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.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Remarques

Cette méthode se substitue à TextWriter.Write.This method overrides 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.The specified characters are written to the underlying stream unless the end of the stream is reached prematurely. Si AutoFlush est true , Flush est appelé automatiquement.If AutoFlush is true, Flush is invoked automatically.

Cette méthode peut fournir des performances plus rapides que Write ( char[],``int,``int ), car elle a moins d’arguments à vérifier.This method might provide faster performance than Write (char[],``int,``int) because it has fewer arguments to check.

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

Voir aussi

S’applique à

Write(Char)

Écrit un caractère dans le flux.Writes a character to the stream.

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.The character to write to the stream.

Exceptions

Une erreur d’E/S se produit.An I/O error occurs.

AutoFlush a la valeur true ou la mémoire tampon de StreamWriter est saturée, et le writer actuel est fermé.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

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.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Remarques

Cette méthode se substitue à TextWriter.Write.This method overrides 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.The specified character is written to the underlying stream unless the end of the stream is reached prematurely. Si AutoFlush est true , Flush est appelé automatiquement.If AutoFlush is true, Flush is invoked automatically.

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

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).Writes a formatted string to the stream, using the same semantics as the Format(String, Object) method.

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.A composite format string.

arg0
Object

Objet à mettre en forme et à écrire.The object to format and write.

Remarques

Write(String, Object)Pour obtenir une description des fonctionnalités de mise en forme composite proposées, consultez.See Write(String, Object) for a description of the composite formatting capabilities offered.

S’applique à