TextWriter.Write Méthode

Définition

Espace de noms:

System.IO

Assembly:

System.Runtime.dll

É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 à l’aide de 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 à l’aide de 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 à l’aide de la même sémantique que la méthode Format(String, Object).
Write(UInt64)	Écrit la représentation textuelle d’un entier non signé de 8 octets dans le flux de texte.
Write(UInt32)	Écrit la représentation textuelle d’un entier non signé de 4 octets dans le flux de texte.
Write(StringBuilder)	Écrit un générateur de chaînes dans le flux de texte.
Write(String)	Écrit une chaîne dans le flux de texte.
Write(Single)	Écrit la représentation textuelle 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 à l’aide de la même sémantique que la méthode Format(String, Object, Object).
Write(Object)	Écrit la représentation textuelle d’un objet dans le flux de texte en appelant la méthode ToString sur cet objet.
Write(Int64)	Écrit la représentation textuelle d’un entier signé de 8 octets dans le flux de texte.
Write(Int32)	Écrit la représentation textuelle d’un entier signé de 4 octets dans le flux de texte.
Write(Double)	Écrit la représentation textuelle d’une valeur à virgule flottante de 8 octets dans le flux de texte.
Write(Decimal)	Écrit la représentation textuelle 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 textuelle d’une valeur Boolean dans le flux de texte.
Write(ReadOnlySpan<Char>)	Écrit une étendue de caractères dans le flux de texte.

Write(String, Object, Object, Object)

Source:

TextWriter.cs

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

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

ArgumentNullException

format est null.

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

FormatException

format n’est pas une chaîne de format composite valide.

-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, est de 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 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 de 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 types de mise en forme.

Le paramètre format se compose de zéro ou plusieurs exécutions de texte mélangées avec zéro ou plus d’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[,longueur][ :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, notamment la syntaxe d’un élément de format, consultez de mise en forme composite.

Élément	Description
index	Position de base zéro dans la liste de paramètres de l’objet à mettre en forme. Si l’objet spécifié par 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 index doit toujours être 0, 1 ou 2. S’il n’existe aucun paramètre dans l’index position, une 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 ; s’il est négatif, il est aligné à 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 identiques aux valeurs prises en charge par la méthode ToString(string format) de l’objet. Si formatString n’est pas spécifié et que l’objet à mettre en forme implémente l’interface de IFormattable, null est passé comme valeur du paramètre format utilisé comme chaîne de format IFormattable.ToString.

Les caractères d’accolades de début et de fin, « { » et « } » sont requis. Pour spécifier un caractère d’accolade littéral unique dans format, spécifiez deux caractères d’accolades de début ou de fin ; autrement dit, « {{ » ou « }} ».

Cette méthode ne recherche pas la chaîne spécifiée pour rechercher des caractères de nouvelle ligne individuels (0x000a hexadécimal) et les remplacer par TextWriter.NewLine.

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 d’E/S courantes.

Voir aussi

• StreamWriter
• StringWriter
• IFormatProvider
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(Char[], Int32, Int32)

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 écrire des données.

index

Int32

Position de caractère dans la mémoire tampon à laquelle commencer la récupération des données.

count

Int32

Nombre de caractères à écrire.

Exceptions

ArgumentException

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

ArgumentNullException

Le paramètre buffer est null.

ArgumentOutOfRangeException

index ou count est négatif.

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

Remarques

Cette méthode écrit count caractères de données dans cette TextWriter à partir du tableau de caractères buffer à partir de la position index.

Cette surcharge équivaut à la surcharge Write(Char[]) pour chaque caractère dans buffer entre index et (index + count).

Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.

Voir aussi

• Write(Char[], Int32, Int32)
• Write(Char[], Int32, Int32)
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(String, Object[])

Source:

TextWriter.cs

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

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 qui contient zéro ou plusieurs objets à mettre en forme et écrire.

Exceptions

ArgumentNullException

format ou arg est null.

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

FormatException

format n’est pas une chaîne de format composite valide.

-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 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 de 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 types de mise en forme.

Le paramètre format se compose de zéro ou plusieurs exécutions de texte mélangées avec zéro ou plus d’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[,longueur][ :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, notamment la syntaxe d’un élément de format, consultez de mise en forme composite.

Élément	Description
index	Position de base zéro dans la liste de paramètres de l’objet à mettre en forme. Si l’objet spécifié par index est null, l’élément de format est remplacé par String.Empty. Étant donné que cette surcharge a un tableau dans sa liste de paramètres, la valeur de 'index doit toujours être inférieure à la longueur du tableau. S’il n’existe aucun paramètre dans l’index position, une 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 ; s’il est négatif, il est aligné à 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 identiques aux valeurs prises en charge par la méthode ToString(string format) de l’objet. Si formatString n’est pas spécifié et que l’objet à mettre en forme implémente l’interface de IFormattable, null est passé comme valeur du paramètre format utilisé comme chaîne de format IFormattable.ToString.

Les caractères d’accolades de début et de fin, « { » et « } » sont requis. Pour spécifier un caractère d’accolade littéral unique dans format, spécifiez deux caractères d’accolades de début ou de fin ; autrement dit, « {{ » ou « }} ».

Cette méthode ne recherche pas la chaîne spécifiée pour rechercher des caractères de nouvelle ligne individuels (0x000a hexadécimal) et les remplacer par TextWriter.NewLine.

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 d’E/S courantes.

Voir aussi

• StreamWriter
• StringWriter
• IFormatProvider
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(String, Object)

Source:

TextWriter.cs

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

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

ArgumentNullException

format est null.

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

FormatException

format n’est pas une chaîne de format composite valide.

-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, est 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 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 de 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 types de mise en forme.

Le paramètre format se compose de zéro ou plusieurs exécutions de texte mélangées avec zéro ou plus d’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[,longueur][ :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, notamment la syntaxe d’un élément de format, consultez de mise en forme composite.

Élément	Description
index	Position de base zéro dans la liste de paramètres de l’objet à mettre en forme. Si l’objet spécifié par 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 'index doit toujours être 0. S’il n’existe aucun paramètre dans l’index position, une 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 ; s’il est négatif, il est aligné à 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 identiques aux valeurs prises en charge par la méthode ToString(string format) de l’objet. Si formatString n’est pas spécifié et que l’objet à mettre en forme implémente l’interface de IFormattable, null est passé comme valeur du paramètre format utilisé comme chaîne de format IFormattable.ToString.

Les caractères d’accolades de début et de fin, « { » et « } » sont requis. Pour spécifier un caractère d’accolade littéral unique dans format, spécifiez deux caractères d’accolades de début ou de fin ; autrement dit, « {{ » ou « }} ».

Cette méthode ne recherche pas la chaîne spécifiée pour rechercher des caractères de nouvelle ligne individuels (0x000a hexadécimal) et les remplacer par TextWriter.NewLine.

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 d’E/S courantes.

Voir aussi

• StreamWriter
• StringWriter
• IFormatProvider
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(UInt64)

Source:

TextWriter.cs

Important

Cette API n’est pas conforme CLS.

Écrit la représentation textuelle 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

CLSCompliantAttribute

Exceptions

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

Remarques

La représentation textuelle de la valeur spécifiée est produite en appelant la méthode UInt64.ToString. La propriété TextWriter.FormatProvider, si elle n’est pas null, spécifie la mise en forme spécifique à la culture.

Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.

Voir aussi

• StreamWriter
• StringWriter
• IFormatProvider
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(UInt32)

Source:

TextWriter.cs

Important

Cette API n’est pas conforme CLS.

Écrit la représentation textuelle 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

CLSCompliantAttribute

Exceptions

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

Remarques

La représentation textuelle de la valeur spécifiée est produite en appelant la méthode UInt32.ToString. La propriété TextWriter.FormatProvider, si elle n’est pas null, spécifie la mise en forme spécifique à la culture.

Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.

Voir aussi

• StreamWriter
• StringWriter
• IFormatProvider
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(StringBuilder)

Source:

TextWriter.cs

Écrit un générateur de chaînes 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, en tant que générateur de chaînes, pour écrire dans le flux de texte.

Remarques

Cette méthode équivaut à Write(stringBuilder.ToString()), mais elle utilise la méthode StringBuilder.GetChunks pour éviter de créer la chaîne intermédiaire.

Write(String)

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

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

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

Remarques

Cette surcharge équivaut à la surcharge Write(Char[]).

Cette méthode ne recherche pas la chaîne spécifiée pour rechercher des caractères de nouvelle ligne individuels (0x000a hexadécimal) et les remplacer par TextWriter.NewLine.

Si value est null, rien n’est écrit dans le flux de texte.

Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.

Voir aussi

• Write(String)
• Write(String)
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(Single)

Source:

TextWriter.cs

Écrit la représentation textuelle 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

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

Remarques

La représentation textuelle de la valeur spécifiée est produite en appelant la méthode Single.ToString. La propriété TextWriter.FormatProvider, si elle n’est pas null, spécifie la mise en forme spécifique à la culture.

Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.

Voir aussi

• StreamWriter
• StringWriter
• IFormatProvider
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(String, Object, Object)

Source:

TextWriter.cs

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

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

ArgumentNullException

format est null.

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

FormatException

format n’est pas une chaîne de format composite valide.

-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, est 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 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 de 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 types de mise en forme.

Le paramètre format se compose de zéro ou plusieurs exécutions de texte mélangées avec zéro ou plus d’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[,longueur][ :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, notamment la syntaxe d’un élément de format, consultez de mise en forme composite.

Élément	Description
index	Position de base zéro dans la liste de paramètres de l’objet à mettre en forme. Si l’objet spécifié par index est null, l’élément de format est remplacé par String.Empty. Étant donné que cette surcharge comporte deux objets dans sa liste de paramètres, la valeur de index doit toujours être 0 ou 1. S’il n’existe aucun paramètre dans l’index position, une 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 ; s’il est négatif, il est aligné à 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 identiques aux valeurs prises en charge par la méthode ToString(string format) de l’objet. Si formatString n’est pas spécifié et que l’objet à mettre en forme implémente l’interface de IFormattable, null est passé comme valeur du paramètre format utilisé comme chaîne de format IFormattable.ToString.

Les caractères d’accolades de début et de fin, « { » et « } » sont requis. Pour spécifier un caractère d’accolade littéral unique dans format, spécifiez deux caractères d’accolades de début ou de fin ; autrement dit, « {{ » ou « }} ».

Cette méthode ne recherche pas la chaîne spécifiée pour rechercher des caractères de nouvelle ligne individuels (0x000a hexadécimal) et les remplacer par TextWriter.NewLine.

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 d’E/S courantes.

Voir aussi

• StreamWriter
• StringWriter
• IFormatProvider
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(Object)

Source:

TextWriter.cs

Écrit la représentation textuelle 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);

abstract member Write : obj -> unit
override this.Write : obj -> unit

Public Overridable Sub Write (value As Object)

Paramètres

value

Object

Objet à écrire.

Exceptions

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

Remarques

Cette surcharge équivaut à la surcharge Write(String).

Si l’objet spécifié est null, aucune action n’est effectuée et aucune exception n’est levée. Sinon, la méthode ToString de l’objet est appelée pour produire la représentation sous forme de chaîne, et la chaîne résultante est ensuite écrite dans le flux de sortie. La propriété FormatProvider, si elle n’est pas null, spécifie la mise en forme spécifique à la culture.

Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.

Voir aussi

• StreamWriter
• StringWriter
• IFormatProvider
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(Int64)

Source:

TextWriter.cs

Écrit la représentation textuelle 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

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

Remarques

La représentation textuelle de la valeur spécifiée est produite en appelant la méthode Int64.ToString. La propriété TextWriter.FormatProvider, si elle n’est pas null, spécifie la mise en forme spécifique à la culture.

Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.

Comment : écrire du texte dans un fichier

Voir aussi

• StreamWriter
• StringWriter
• IFormatProvider

Write(Int32)

Source:

TextWriter.cs

Écrit la représentation textuelle 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

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

Remarques

La représentation textuelle de la valeur spécifiée est produite en appelant la méthode Int32.ToString. La propriété TextWriter.FormatProvider, si elle n’est pas null, spécifie la mise en forme spécifique à la culture.

Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.

Voir aussi

• StreamWriter
• StringWriter
• IFormatProvider
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(Double)

Source:

TextWriter.cs

Écrit la représentation textuelle 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

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

Remarques

La représentation textuelle de la valeur spécifiée est produite en appelant la méthode Double.ToString. La propriété TextWriter.FormatProvider, si elle n’est pas null, spécifie la mise en forme spécifique à la culture.

Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.

Voir aussi

• StreamWriter
• StringWriter
• IFormatProvider
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(Decimal)

Source:

TextWriter.cs

Écrit la représentation textuelle 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

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

Remarques

La propriété FormatProvider, si elle n’est pas null, spécifie la mise en forme spécifique à la culture.

Voir aussi

• StreamWriter
• StringWriter
• IFormatProvider
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(Char[])

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

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

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

Remarques

Cette méthode ne recherche pas la chaîne spécifiée pour rechercher des caractères de nouvelle ligne individuels (0x000a hexadécimal) et les remplacer par NewLine.

Cette méthode par défaut appelle la méthode Write(Char[], Int32, Int32) et transmet l’ensemble 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 d’E/S courantes.

Voir aussi

• Write(Char[])
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(Char)

Source:

TextWriter.cs

Écrit un caractère dans le flux de texte.

public:
 virtual void Write(char value);

public virtual void Write (char value);

abstract member Write : char -> unit
override this.Write : char -> unit

Public Overridable Sub Write (value As Char)

Paramètres

value

Char

Caractère à écrire dans le flux de texte.

Exceptions

ObjectDisposedException

La TextWriter est fermée.

IOException

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 d’E/S courantes.

Voir aussi

• Write(Char)
• Write(Char)
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(Boolean)

Source:

TextWriter.cs

Écrit la représentation textuelle 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

Valeur Boolean à écrire.

Exceptions

ObjectDisposedException

La TextWriter est fermée.

IOException

Une erreur d’E/S se produit.

Remarques

La représentation textuelle de la valeur spécifiée est produite en appelant la méthode Boolean.ToString.

Cette méthode génère Boolean.TrueString ou Boolean.FalseString.

Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.

Voir aussi

• StreamWriter
• StringWriter
• fichier et flux d’E/S
• Guide pratique pour lire du texte à partir d’un fichier
• Comment : écrire du texte dans un fichier

Write(ReadOnlySpan<Char>)

Source:

TextWriter.cs

Écrit une étendue 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>

Étendue de caractères à écrire.

Remarques

La représentation textuelle de la valeur spécifiée est produite en appelant le ReadOnlySpan<Char>. Méthode toString.

Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.