TextWriter.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 un flux de texte.
Surcharges
Write(String, Object, Object, Object) |
Écrit une chaîne mise en forme dans le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object, Object, Object). |
Write(Char[], Int32, Int32) |
Écrit un sous-tableau de caractères dans le flux de texte. |
Write(String, Object[]) |
Écrit une chaîne mise en forme dans le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object[]). |
Write(String, Object) |
Écrit une chaîne mise en forme dans le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object). |
Write(UInt64) |
Écrit la représentation sous forme de texte d’un entier non signé de 8 octets dans le flux de texte. |
Write(UInt32) |
Écrit la représentation sous forme de texte d’un entier non signé de 4 octets dans le flux de texte. |
Write(StringBuilder) |
Écrit un générateur de chaîne dans le flux de texte. |
Write(String) |
Écrit une chaîne dans le flux de texte. |
Write(Single) |
Écrit la représentation sous forme de texte d’une valeur à virgule flottante de 4 octets dans le flux de texte. |
Write(String, Object, Object) |
Écrit une chaîne mise en forme dans le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object, Object). |
Write(Object) |
Écrit la représentation sous forme de texte d’un objet dans le flux de texte en appelant la méthode |
Write(Int64) |
Écrit la représentation sous forme de texte d’un entier signé de 8 octets dans le flux de texte. |
Write(Int32) |
Écrit la représentation sous forme de texte d’un entier signé de 4 octets dans le flux de texte. |
Write(Double) |
Écrit la représentation sous forme de texte d’une valeur à virgule flottante de 8 octets dans le flux de texte. |
Write(Decimal) |
Écrit la représentation sous forme de texte d’une valeur décimale dans le flux de texte. |
Write(Char[]) |
Écrit un tableau de caractères dans le flux de texte. |
Write(Char) |
Écrit un caractère dans le flux de texte. |
Write(Boolean) |
Écrit la représentation sous forme de texte d’une valeur |
Write(ReadOnlySpan<Char>) |
Écrit une plage de caractères dans le flux de texte. |
Write(String, Object, Object, Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit une chaîne mise en forme dans le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object, Object, Object).
public:
virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public virtual void Write (string format, object arg0, object arg1, object arg2);
public virtual void Write (string format, object? arg0, object? arg1, object? arg2);
abstract member Write : string * obj * obj * obj -> unit
override this.Write : string * obj * obj * obj -> unit
Public Overridable 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.
Exceptions
format
a la valeur null
.
Le TextWriter est fermé.
Une erreur d’E/S se produit.
format
n'est pas une chaîne de format composite.
- ou -
L'index d'un élément de format est inférieur à 0 (zéro) ou supérieur ou égal au nombre d'objets à mettre en forme (qui, pour cette surcharge de méthode, s'élève à trois).
Remarques
Cette méthode utilise la mise en forme composite pour convertir la valeur d’un objet en sa représentation sous forme de chaîne et pour incorporer cette représentation dans une chaîne. .NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :
Pour plus d’informations sur la fonctionnalité de mise en forme composite, consultez Mise en forme composite.
Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et Chaînes de format numérique personnalisées.
Pour plus d’informations sur les spécificateurs de format de date et d’heure, consultez Chaînes de format de date et d’heure standard et Chaînes de format de date et d’heure personnalisées.
Pour plus d’informations sur les spécificateurs de format d’énumération, consultez Chaînes de format d’énumération.
Pour plus d’informations sur la mise en forme, consultez Mise en forme des types.
Le format
paramètre se compose de zéro ou plusieurs exécutions de texte mélangées avec zéro ou plusieurs espaces réservés indexés, appelés éléments de format, qui correspondent à un objet dans la liste de paramètres de cette méthode. Le processus de mise en forme remplace chaque élément de format par la représentation sous forme de chaîne de la valeur de l’objet correspondant.
La syntaxe d’un élément de format est la suivante :
{index[,length][ :formatString]}
Les éléments entre crochets sont facultatifs. Le tableau suivant décrit chaque élément. Pour plus d’informations sur la fonctionnalité de mise en forme composite, y compris la syntaxe d’un élément de format, consultez Mise en forme composite.
Élément | Description |
---|---|
index | Position de base zéro dans la liste des paramètres de l’objet à mettre en forme. Si l’objet spécifié par l’index est null , l’élément de format est remplacé par String.Empty. Étant donné que cette surcharge comporte trois objets dans sa liste de paramètres, la valeur de l’index doit toujours être 0, 1 ou 2. S’il n’y a aucun paramètre dans la position d’index , un FormatException est levée. |
,longueur | Nombre minimal de caractères dans la représentation sous forme de chaîne du paramètre. S’il est positif, le paramètre est aligné à droite ; si elle est négative, elle est alignée à gauche. |
:formatString | Chaîne de format standard ou personnalisée prise en charge par l’objet à mettre en forme. Les valeurs possibles pour formatString sont les mêmes que les valeurs prises en charge par la méthode de ToString(string format) l’objet. Si formatString n’est pas spécifié et que l’objet à mettre en forme implémente l’interface IFormattable , null est passé comme valeur du format paramètre utilisé comme chaîne de IFormattable.ToString format. |
Les caractères d’accolade de début et de fin, « { » et « } », sont obligatoires. Pour spécifier un caractère d’accolade littéral unique dans format
, spécifiez deux caractères d’accolade de début ou de fin, c’est-à-dire « {{ » ou « }} ».
Cette méthode ne recherche pas dans la chaîne spécifiée des caractères de nouvelle ligne individuels (0x000a hexadécimaux) et les TextWriter.NewLineremplace par .
Si un objet spécifié n’est pas référencé dans la chaîne de format, il est ignoré.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- StreamWriter
- StringWriter
- IFormatProvider
- 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[], Int32, Int32)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit un sous-tableau de caractères dans le flux de texte.
public:
virtual void Write(cli::array <char> ^ buffer, int index, int count);
public virtual void Write (char[] buffer, int index, int count);
abstract member Write : char[] * int * int -> unit
override this.Write : char[] * int * int -> unit
Public Overridable Sub Write (buffer As Char(), index As Integer, count As Integer)
Paramètres
- buffer
- Char[]
Tableau de caractères à partir duquel les données doivent être écrites.
- index
- Int32
Position du caractère dans la mémoire tampon à laquelle commencer la récupération des données.
- count
- Int32
Nombre de caractères à écrire.
Exceptions
La longueur de la mémoire tampon moins index
est inférieure à count
.
Le paramètre buffer
a la valeur null
.
index
ou count
est un nombre négatif.
Le TextWriter est fermé.
Une erreur d’E/S se produit.
Remarques
Cette méthode écrit count
des caractères de données dans ce TextWriter
tableau à partir du buffer
tableau de caractères à partir de la position index
.
Cette surcharge équivaut à la Write(Char[]) surcharge pour chaque caractère entre buffer
index
et (index
+ count
).
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- Write(Char[], Int32, Int32)
- Write(Char[], Int32, Int32)
- 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:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit une chaîne mise en forme dans le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object[]).
public:
virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void Write (string format, params object[] arg);
public virtual void Write (string format, params object?[] arg);
abstract member Write : string * obj[] -> unit
override this.Write : string * obj[] -> unit
Public Overridable 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.
Exceptions
format
ou arg
est null
.
Le TextWriter est fermé.
Une erreur d’E/S se produit.
format
n'est pas une chaîne de format composite.
- ou -
L’index d’un élément de format est inférieur à 0 (zéro), ou supérieur ou égal à la longueur du tableau arg
.
Remarques
Cette méthode utilise la mise en forme composite pour convertir la valeur d’un objet en sa représentation sous forme de chaîne et pour incorporer cette représentation dans une chaîne. .NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :
Pour plus d’informations sur la fonctionnalité de mise en forme composite, consultez Mise en forme composite.
Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et Chaînes de format numérique personnalisées.
Pour plus d’informations sur les spécificateurs de format de date et d’heure, consultez Chaînes de format de date et d’heure standard et Chaînes de format de date et d’heure personnalisées.
Pour plus d’informations sur les spécificateurs de format d’énumération, consultez Chaînes de format d’énumération.
Pour plus d’informations sur la mise en forme, consultez Mise en forme des types.
Le format
paramètre se compose de zéro ou plusieurs exécutions de texte mélangées avec zéro ou plusieurs espaces réservés indexés, appelés éléments de format, qui correspondent à un objet dans la liste de paramètres de cette méthode. Le processus de mise en forme remplace chaque élément de format par la représentation sous forme de chaîne de la valeur de l’objet correspondant.
La syntaxe d’un élément de format est la suivante :
{index[,length][ :formatString]}
Les éléments entre crochets sont facultatifs. Le tableau suivant décrit chaque élément. Pour plus d’informations sur la fonctionnalité de mise en forme composite, y compris la syntaxe d’un élément de format, consultez Mise en forme composite.
Élément | Description |
---|---|
index | Position de base zéro dans la liste des paramètres de l’objet à mettre en forme. Si l’objet spécifié par l’index est null , l’élément de format est remplacé par String.Empty. Étant donné que cette surcharge comporte un tableau dans sa liste de paramètres, la valeur de l’index doit toujours être inférieure à la longueur du tableau. S’il n’y a aucun paramètre dans la position d’index , un FormatException est levée. |
,longueur | Nombre minimal de caractères dans la représentation sous forme de chaîne du paramètre. S’il est positif, le paramètre est aligné à droite ; si elle est négative, elle est alignée à gauche. |
:formatString | Chaîne de format standard ou personnalisée prise en charge par l’objet à mettre en forme. Les valeurs possibles pour formatString sont les mêmes que les valeurs prises en charge par la méthode de ToString(string format) l’objet. Si formatString n’est pas spécifié et que l’objet à mettre en forme implémente l’interface IFormattable , null est passé comme valeur du format paramètre utilisé comme chaîne de IFormattable.ToString format. |
Les caractères d’accolade de début et de fin, « { » et « } », sont obligatoires. Pour spécifier un caractère d’accolade littéral unique dans format
, spécifiez deux caractères d’accolade de début ou de fin, c’est-à-dire « {{ » ou « }} ».
Cette méthode ne recherche pas dans la chaîne spécifiée des caractères de nouvelle ligne individuels (0x000a hexadécimaux) et les TextWriter.NewLineremplace par .
Si un objet spécifié n’est pas référencé dans la chaîne de format, il est ignoré.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- StreamWriter
- StringWriter
- IFormatProvider
- 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:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit une chaîne mise en forme dans le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object).
public:
virtual void Write(System::String ^ format, System::Object ^ arg0);
public virtual void Write (string format, object arg0);
public virtual void Write (string format, object? arg0);
abstract member Write : string * obj -> unit
override this.Write : string * obj -> unit
Public Overridable 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.
Exceptions
format
a la valeur null
.
Le TextWriter est fermé.
Une erreur d’E/S se produit.
format
n'est pas une chaîne de format composite.
- ou -
L'index d'un élément de format est inférieur à 0 (zéro) ou supérieur ou égal au nombre d'objets à mettre en forme (qui, pour cette surcharge de méthode, s'élève à un).
Remarques
Cette méthode utilise la mise en forme composite pour convertir la valeur d’un objet en sa représentation sous forme de chaîne et pour incorporer cette représentation dans une chaîne. .NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :
Pour plus d’informations sur la fonctionnalité de mise en forme composite, consultez Mise en forme composite.
Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et Chaînes de format numérique personnalisées.
Pour plus d’informations sur les spécificateurs de format de date et d’heure, consultez Chaînes de format de date et d’heure standard et Chaînes de format de date et d’heure personnalisées.
Pour plus d’informations sur les spécificateurs de format d’énumération, consultez Chaînes de format d’énumération.
Pour plus d’informations sur la mise en forme, consultez Mise en forme des types.
Le format
paramètre se compose de zéro ou plusieurs exécutions de texte mélangées avec zéro ou plusieurs espaces réservés indexés, appelés éléments de format, qui correspondent à un objet dans la liste de paramètres de cette méthode. Le processus de mise en forme remplace chaque élément de format par la représentation sous forme de chaîne de la valeur de l’objet correspondant.
La syntaxe d’un élément de format est la suivante :
{index[,length][ :formatString]}
Les éléments entre crochets sont facultatifs. Le tableau suivant décrit chaque élément. Pour plus d’informations sur la fonctionnalité de mise en forme composite, y compris la syntaxe d’un élément de format, consultez Mise en forme composite.
Élément | Description |
---|---|
index | Position de base zéro dans la liste des paramètres de l’objet à mettre en forme. Si l’objet spécifié par l’index est null , l’élément de format est remplacé par String.Empty. Étant donné que cette surcharge n’a qu’un seul objet dans sa liste de paramètres, la valeur de l’index doit toujours être 0. S’il n’y a aucun paramètre dans la position d’index , un FormatException est levée. |
,longueur | Nombre minimal de caractères dans la représentation sous forme de chaîne du paramètre. S’il est positif, le paramètre est aligné à droite ; si elle est négative, elle est alignée à gauche. |
:formatString | Chaîne de format standard ou personnalisée prise en charge par l’objet à mettre en forme. Les valeurs possibles pour formatString sont les mêmes que les valeurs prises en charge par la méthode de ToString(string format) l’objet. Si formatString n’est pas spécifié et que l’objet à mettre en forme implémente l’interface IFormattable , null est passé comme valeur du format paramètre utilisé comme chaîne de IFormattable.ToString format. |
Les caractères d’accolade de début et de fin, « { » et « } », sont obligatoires. Pour spécifier un caractère d’accolade littéral unique dans format
, spécifiez deux caractères d’accolade de début ou de fin, c’est-à-dire « {{ » ou « }} ».
Cette méthode ne recherche pas dans la chaîne spécifiée des caractères de nouvelle ligne individuels (0x000a hexadécimaux) et les TextWriter.NewLineremplace par .
Si un objet spécifié n’est pas référencé dans la chaîne de format, il est ignoré.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- StreamWriter
- StringWriter
- IFormatProvider
- 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(UInt64)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Important
Cette API n’est pas conforme CLS.
Écrit la représentation sous forme de texte d’un entier non signé de 8 octets dans le flux de texte.
public:
virtual void Write(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void Write (ulong value);
[<System.CLSCompliant(false)>]
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit
Public Overridable Sub Write (value As ULong)
Paramètres
- value
- UInt64
Entier non signé de 8 octets à écrire.
- Attributs
Exceptions
Le TextWriter est fermé.
Une erreur d’E/S se produit.
Remarques
La représentation textuelle de la valeur spécifiée est produite en appelant la UInt64.ToString méthode . Si TextWriter.FormatProvider ce n’est pas null
le cas, la propriété spécifie la mise en forme propre à la culture.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- StreamWriter
- StringWriter
- IFormatProvider
- 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(UInt32)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Important
Cette API n’est pas conforme CLS.
Écrit la représentation sous forme de texte d’un entier non signé de 4 octets dans le flux de texte.
public:
virtual void Write(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void Write (uint value);
[<System.CLSCompliant(false)>]
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit
Public Overridable Sub Write (value As UInteger)
Paramètres
- value
- UInt32
Entier non signé de 4 octets à écrire.
- Attributs
Exceptions
Le TextWriter est fermé.
Une erreur d’E/S se produit.
Remarques
La représentation textuelle de la valeur spécifiée est produite en appelant la UInt32.ToString méthode . Si TextWriter.FormatProvider ce n’est pas null
le cas, la propriété spécifie la mise en forme propre à la culture.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- StreamWriter
- StringWriter
- IFormatProvider
- 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(StringBuilder)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit un générateur de chaîne dans le flux de texte.
public:
virtual void Write(System::Text::StringBuilder ^ value);
public virtual void Write (System.Text.StringBuilder? value);
abstract member Write : System.Text.StringBuilder -> unit
override this.Write : System.Text.StringBuilder -> unit
Public Overridable Sub Write (value As StringBuilder)
Paramètres
- value
- StringBuilder
Chaîne, sous la forme d’un générateur de chaîne, à écrire dans le flux de texte.
Remarques
Cette méthode est équivalente à Write(stringBuilder.ToString())
, mais elle utilise la StringBuilder.GetChunks méthode pour éviter de créer la chaîne intermédiaire.
S’applique à
Write(String)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit une chaîne dans le flux de texte.
public:
virtual void Write(System::String ^ value);
public virtual void Write (string value);
public virtual void Write (string? value);
abstract member Write : string -> unit
override this.Write : string -> unit
Public Overridable Sub Write (value As String)
Paramètres
- value
- String
Chaîne à écrire.
Exceptions
Le TextWriter est fermé.
Une erreur d’E/S se produit.
Remarques
Cette surcharge équivaut à la Write(Char[]) surcharge.
Cette méthode ne recherche pas dans la chaîne spécifiée des caractères de nouvelle ligne individuels (0x000a hexadécimaux) et les TextWriter.NewLineremplace par .
Si value
a la valeur null
, rien n'est écrit dans le flux de texte.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- Write(String)
- Write(String)
- 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(Single)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation sous forme de texte d’une valeur à virgule flottante de 4 octets dans le flux de texte.
public:
virtual void Write(float value);
public virtual void Write (float value);
abstract member Write : single -> unit
override this.Write : single -> unit
Public Overridable Sub Write (value As Single)
Paramètres
- value
- Single
Valeur à virgule flottante de 4 octets à écrire.
Exceptions
Le TextWriter est fermé.
Une erreur d’E/S se produit.
Remarques
La représentation textuelle de la valeur spécifiée est produite en appelant la Single.ToString méthode . Si TextWriter.FormatProvider ce n’est pas null
le cas, la propriété spécifie la mise en forme propre à la culture.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- StreamWriter
- StringWriter
- IFormatProvider
- 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, Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit une chaîne mise en forme dans le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object, Object).
public:
virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void Write (string format, object arg0, object arg1);
public virtual void Write (string format, object? arg0, object? arg1);
abstract member Write : string * obj * obj -> unit
override this.Write : string * obj * obj -> unit
Public Overridable 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.
Exceptions
format
a la valeur null
.
Le TextWriter est fermé.
Une erreur d’E/S se produit.
format
n'est pas une chaîne de format composite.
- ou -
L'index d'un élément de format est inférieur à 0 (zéro) ou supérieur ou égal au nombre d'objets à mettre en forme (qui, pour cette surcharge de méthode, s'élève à deux).
Remarques
Cette méthode utilise la mise en forme composite pour convertir la valeur d’un objet en sa représentation sous forme de chaîne et pour incorporer cette représentation dans une chaîne. .NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :
Pour plus d’informations sur la fonctionnalité de mise en forme composite, consultez Mise en forme composite.
Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et Chaînes de format numérique personnalisées.
Pour plus d’informations sur les spécificateurs de format de date et d’heure, consultez Chaînes de format de date et d’heure standard et Chaînes de format de date et d’heure personnalisées.
Pour plus d’informations sur les spécificateurs de format d’énumération, consultez Chaînes de format d’énumération.
Pour plus d’informations sur la mise en forme, consultez Mise en forme des types.
Le format
paramètre se compose de zéro ou plusieurs exécutions de texte mélangées avec zéro ou plusieurs espaces réservés indexés, appelés éléments de format, qui correspondent à un objet dans la liste de paramètres de cette méthode. Le processus de mise en forme remplace chaque élément de format par la représentation sous forme de chaîne de la valeur de l’objet correspondant.
La syntaxe d’un élément de format est la suivante :
{index[,length][ :formatString]}
Les éléments entre crochets sont facultatifs. Le tableau suivant décrit chaque élément. Pour plus d’informations sur la fonctionnalité de mise en forme composite, y compris la syntaxe d’un élément de format, consultez Mise en forme composite.
Élément | Description |
---|---|
index | Position de base zéro dans la liste des paramètres de l’objet à mettre en forme. Si l’objet spécifié par l’index est null , l’élément de format est remplacé par String.Empty. Étant donné que cette surcharge a deux objets dans sa liste de paramètres, la valeur de l’index doit toujours être 0 ou 1. S’il n’y a aucun paramètre dans la position d’index , un FormatException est levée. |
,longueur | Nombre minimal de caractères dans la représentation sous forme de chaîne du paramètre. S’il est positif, le paramètre est aligné à droite ; si elle est négative, elle est alignée à gauche. |
:formatString | Chaîne de format standard ou personnalisée prise en charge par l’objet à mettre en forme. Les valeurs possibles pour formatString sont les mêmes que les valeurs prises en charge par la méthode de ToString(string format) l’objet. Si formatString n’est pas spécifié et que l’objet à mettre en forme implémente l’interface IFormattable , null est passé comme valeur du format paramètre utilisé comme chaîne de IFormattable.ToString format. |
Les caractères d’accolade de début et de fin, « { » et « } », sont obligatoires. Pour spécifier un caractère d’accolade littéral unique dans format
, spécifiez deux caractères d’accolade de début ou de fin, c’est-à-dire « {{ » ou « }} ».
Cette méthode ne recherche pas dans la chaîne spécifiée des caractères de nouvelle ligne individuels (0x000a hexadécimaux) et les TextWriter.NewLineremplace par .
Si un objet spécifié n’est pas référencé dans la chaîne de format, il est ignoré.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- StreamWriter
- StringWriter
- IFormatProvider
- 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(Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation sous forme de texte d’un objet dans le flux de texte en appelant la méthode ToString
sur cet objet.
public:
virtual void Write(System::Object ^ value);
public virtual void Write (object value);
public virtual void Write (object? value);
abstract member Write : obj -> unit
override this.Write : obj -> unit
Public Overridable Sub Write (value As Object)
Paramètres
- value
- Object
Objet à écrire.
Exceptions
Le TextWriter est fermé.
Une erreur d’E/S se produit.
Remarques
Cette surcharge équivaut à la Write(String) surcharge.
Si l’objet spécifié est null
, aucune action n’est effectuée et aucune exception n’est levée. Sinon, la méthode de ToString
l’objet est appelée pour produire la représentation de chaîne, et la chaîne résultante est ensuite écrite dans le flux de sortie. Si FormatProvider ce n’est pas null
le cas, la propriété spécifie la mise en forme propre à la culture.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- StreamWriter
- StringWriter
- IFormatProvider
- 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(Int64)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation sous forme de texte d’un entier signé de 8 octets dans le flux de texte.
public:
virtual void Write(long value);
public virtual void Write (long value);
abstract member Write : int64 -> unit
override this.Write : int64 -> unit
Public Overridable Sub Write (value As Long)
Paramètres
- value
- Int64
Entier signé de 8 octets à écrire.
Exceptions
Le TextWriter est fermé.
Une erreur d’E/S se produit.
Remarques
La représentation textuelle de la valeur spécifiée est produite en appelant la Int64.ToString méthode . Si TextWriter.FormatProvider ce n’est pas null
le cas, la propriété spécifie la mise en forme propre à la culture.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Procédure : écrire du texte dans un fichier
Voir aussi
S’applique à
Write(Int32)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation sous forme de texte d’un entier signé de 4 octets dans le flux de texte.
public:
virtual void Write(int value);
public virtual void Write (int value);
abstract member Write : int -> unit
override this.Write : int -> unit
Public Overridable Sub Write (value As Integer)
Paramètres
- value
- Int32
Entier signé de 4 octets à écrire.
Exceptions
Le TextWriter est fermé.
Une erreur d’E/S se produit.
Remarques
La représentation textuelle de la valeur spécifiée est produite en appelant la Int32.ToString méthode . Si TextWriter.FormatProvider ce n’est pas null
le cas, la propriété spécifie la mise en forme propre à la culture.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- StreamWriter
- StringWriter
- IFormatProvider
- 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(Double)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation sous forme de texte d’une valeur à virgule flottante de 8 octets dans le flux de texte.
public:
virtual void Write(double value);
public virtual void Write (double value);
abstract member Write : double -> unit
override this.Write : double -> unit
Public Overridable Sub Write (value As Double)
Paramètres
- value
- Double
Valeur à virgule flottante de 8 octets à écrire.
Exceptions
Le TextWriter est fermé.
Une erreur d’E/S se produit.
Remarques
La représentation textuelle de la valeur spécifiée est produite en appelant la Double.ToString méthode . Si TextWriter.FormatProvider ce n’est pas null
le cas, la propriété spécifie la mise en forme propre à la culture.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- StreamWriter
- StringWriter
- IFormatProvider
- 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(Decimal)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation sous forme de texte d’une valeur décimale dans le flux de texte.
public:
virtual void Write(System::Decimal value);
public virtual void Write (decimal value);
abstract member Write : decimal -> unit
override this.Write : decimal -> unit
Public Overridable Sub Write (value As Decimal)
Paramètres
- value
- Decimal
Valeur décimale à écrire.
Exceptions
Le TextWriter est fermé.
Une erreur d’E/S se produit.
Remarques
Si FormatProvider ce n’est pas null
le cas, la propriété spécifie la mise en forme propre à la culture.
Voir aussi
- StreamWriter
- StringWriter
- IFormatProvider
- 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:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit un tableau de caractères dans le flux de texte.
public:
virtual void Write(cli::array <char> ^ buffer);
public virtual void Write (char[] buffer);
public virtual void Write (char[]? buffer);
abstract member Write : char[] -> unit
override this.Write : char[] -> unit
Public Overridable Sub Write (buffer As Char())
Paramètres
- buffer
- Char[]
Tableau de caractères à écrire dans le flux de texte.
Exceptions
Le TextWriter est fermé.
Une erreur d’E/S se produit.
Remarques
Cette méthode ne recherche pas dans la chaîne spécifiée des caractères de nouvelle ligne individuels (0x000a hexadécimaux) et les NewLineremplace par .
Cette méthode par défaut appelle la Write(Char[], Int32, Int32) méthode et transmet l’intégralité du tableau de caractères. Si le tableau de caractères est null
, rien n’est écrit.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- Write(Char[])
- 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:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit un caractère dans le flux de texte.
public:
abstract void Write(char value);
public:
virtual void Write(char value);
public abstract void Write (char value);
public virtual void Write (char value);
abstract member Write : char -> unit
abstract member Write : char -> unit
override this.Write : char -> unit
Public MustOverride Sub Write (value As Char)
Public Overridable Sub Write (value As Char)
Paramètres
- value
- Char
Caractère à écrire dans le flux de texte.
Exceptions
Le TextWriter est fermé.
Une erreur d’E/S se produit.
Remarques
Cette méthode par défaut ne fait rien, mais les classes dérivées peuvent remplacer la méthode pour fournir les fonctionnalités appropriées.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- Write(Char)
- Write(Char)
- 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(Boolean)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation sous forme de texte d’une valeur Boolean
dans le flux de texte.
public:
virtual void Write(bool value);
public virtual void Write (bool value);
abstract member Write : bool -> unit
override this.Write : bool -> unit
Public Overridable Sub Write (value As Boolean)
Paramètres
- value
- Boolean
La valeur Boolean
à écrire.
Exceptions
Le TextWriter est fermé.
Une erreur d’E/S se produit.
Remarques
La représentation textuelle de la valeur spécifiée est produite en appelant la Boolean.ToString méthode .
Cette méthode génère ou Boolean.TrueStringBoolean.FalseString.
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
Voir aussi
- StreamWriter
- StringWriter
- 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(ReadOnlySpan<Char>)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit une plage de caractères dans le flux de texte.
public:
virtual void Write(ReadOnlySpan<char> buffer);
public virtual void Write (ReadOnlySpan<char> buffer);
abstract member Write : ReadOnlySpan<char> -> unit
override this.Write : ReadOnlySpan<char> -> unit
Public Overridable Sub Write (buffer As ReadOnlySpan(Of Char))
Paramètres
- buffer
- ReadOnlySpan<Char>
Plage de caractères à écrire.
Remarques
La représentation textuelle de la valeur spécifiée est produite en appelant l’objet ReadOnlySpan<Char>. Méthode ToString .
Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Prochainement : Tout au long de l'année 2024, nous supprimerons progressivement les GitHub Issues en tant que mécanisme de retour d'information pour le contenu et nous les remplacerons par un nouveau système de retour d'information. Pour plus d’informations, voir:Soumettre et afficher des commentaires pour