StreamWriter.Write Méthode

Référence

Définition

Espace de noms:: System.IO

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: System.IO.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

.NET 9 et autres versions

Produit	Versions
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9

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 à

.NET 9 et autres versions

Produit	Versions
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9

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

ArgumentNullException

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

NotSupportedException

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 à

.NET 9 et autres versions

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

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 à

.NET 9

Produit	Versions
.NET	9

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 à

.NET 9 et autres versions

Produit	Versions
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9

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 à

.NET 9 et autres versions

Produit	Versions
.NET	Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

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

ObjectDisposedException

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

NotSupportedException

IOException

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 à

.NET 9 et autres versions

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

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

IOException

Une erreur d’E/S se produit.

ObjectDisposedException

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

NotSupportedException

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 à

.NET 9 et autres versions

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

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

IOException

Une erreur d’E/S se produit.

ObjectDisposedException

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

NotSupportedException

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 à

.NET 9 et autres versions

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

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 à

.NET 9 et autres versions

Produit	Versions
.NET	Core 3.0, Core 3.1, 5, 6, 7, 8, 9

Partager via

StreamWriter.Write Méthode

Définition

Surcharges

Write(String, Object, Object, Object)

Paramètres

Remarques

S’applique à

Write(String, Object, Object)

Paramètres

Remarques

S’applique à

Write(Char[], Int32, Int32)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Write(String, ReadOnlySpan<Object>)

Paramètres

S’applique à

Write(String, Object[])

Paramètres

Remarques

S’applique à

Write(ReadOnlySpan<Char>)

Paramètres

S’applique à

Write(String)

Paramètres

Exceptions

Remarques

Voir aussi

S’applique à

Write(Char[])

Paramètres

Exceptions

Remarques

Voir aussi

S’applique à

Write(Char)

Paramètres

Exceptions

Remarques

Voir aussi

S’applique à

Write(String, Object)

Paramètres

Remarques

S’applique à

Ressources supplémentaires