StreamWriter.Write Méthode
Définition
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, 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, ReadOnlySpan<Object>) | |
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(ReadOnlySpan<Char>) |
Écrit une plage 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, en utilisant 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, 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
Consultez Write(String, Object, Object, Object) pour obtenir une description des fonctionnalités de mise en forme composite offertes.
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 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
Consultez Write(String, Object, Object) pour obtenir une description des fonctionnalités de mise en forme composite offertes.
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 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 en buffer
commençant à et en continuant jusqu’à index
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 a la valeur true
.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- Fichier et flux de données E/S
- Procédure : lire le texte d’un fichier
- Procédure : écrire du texte dans un fichier
S’applique à
Write(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
- arg
- ReadOnlySpan<Object>
S’applique à
Write(String, Object[])
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
É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
Consultez Write(String, Object[]) pour obtenir une description des fonctionnalités de mise en forme composite offertes.
S’applique à
Write(ReadOnlySpan<Char>)
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
É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(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 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 a la valeur true
. Si value
a la valeur , aucune entrée n’est null
écrite.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- Fichier et flux de données E/S
- Procédure : lire le texte d’un fichier
- Procédure : écrire du texte dans un fichier
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
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 a la valeur 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 à case activée.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- Fichier et flux de données E/S
- Procédure : lire le texte d’un fichier
- Procédure : écrire du texte dans un fichier
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 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 a la valeur true
, Flush est appelé automatiquement.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- Fichier et flux de données E/S
- Procédure : lire le texte d’un fichier
- Procédure : écrire du texte dans un fichier
S’applique à
Write(String, Object)
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
- Source:
- StreamWriter.cs
É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
Consultez Write(String, Object) pour obtenir une description des fonctionnalités de mise en forme composite offertes.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour