TextWriter.Write Méthode

Définition

Espace de noms:

System.IO

Assemblys:

netstandard.dll, System.Runtime.dll

Écrit des données dans un flux de texte.

Surcharges

Nom	Description
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 Format(String, Object, Object, Object) méthode.
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 Format(String, Object, Object) méthode.
Write(Char[], Int32, Int32)	Écrit un sous-tableau de caractères dans le flux de texte.
Write(String, ReadOnlySpan<Object>)	Écrit une chaîne mise en forme dans le flux de texte, en utilisant la même sémantique que Format(String, ReadOnlySpan<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 Format(String, Object[]) méthode.
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 Format(String, Object) méthode.
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(Decimal)	Écrit la représentation textuelle d’une valeur décimale dans le flux de texte.
Write(ReadOnlySpan<Char>)	Écrit une étendue de caractères dans le flux de texte.
Write(Object)	Écrit la représentation textuelle d’un objet dans le flux de texte en appelant la ToString méthode 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(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 Boolean valeur 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, 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 Format(String, Object, Object, Object) méthode.

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 a la valeur null.

ObjectDisposedException

La TextWriter fermeture est terminé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 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 format paramètre 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[,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, notamment 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 de 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’existe aucun paramètre à la position d’index , un FormatException paramètre est levée.
,length	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 de l’objet ToString(string format) . 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’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écimaux) 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
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour é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 Format(String, Object, Object) méthode.

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 a la valeur null.

ObjectDisposedException

La TextWriter fermeture est terminé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 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 format paramètre 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[,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, notamment 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 de 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 deux objets dans sa liste de paramètres, la valeur de l’index doit toujours être 0 ou 1. S’il n’existe aucun paramètre à la position d’index , un FormatException paramètre est levée.
,length	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 de l’objet ToString(string format) . 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’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écimaux) 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
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour é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 buffer paramètre est null.

ArgumentOutOfRangeException

index ou count est négatif.

ObjectDisposedException

La TextWriter fermeture est terminée.

IOException

Une erreur d’E/S se produit.

Remarques

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

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

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)
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour écrire du texte dans un fichier

Write(String, ReadOnlySpan<Object>)

Source:

TextWriter.cs

Écrit une chaîne mise en forme dans le flux de texte, en utilisant la même sémantique que Format(String, ReadOnlySpan<Object>).

public:
 virtual void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);

public virtual void Write(string format, scoped ReadOnlySpan<object?> arg);

abstract member Write : string * ReadOnlySpan<obj> -> unit
override this.Write : string * ReadOnlySpan<obj> -> unit

Public Overridable 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.

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 Format(String, Object[]) méthode.

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 fermeture est terminé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 arg tableau.

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 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 format paramètre 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[,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, notamment 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 de 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 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’existe aucun paramètre à la position d’index , un FormatException paramètre est levée.
,length	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 de l’objet ToString(string format) . 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’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écimaux) 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
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour é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 Format(String, Object) méthode.

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 a la valeur null.

ObjectDisposedException

La TextWriter fermeture est terminé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 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 format paramètre 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[,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, notamment 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 de 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’existe aucun paramètre à la position d’index , un FormatException paramètre est levée.
,length	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 de l’objet ToString(string format) . 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’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écimaux) 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
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour é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 fermeture est terminé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 UInt64.ToString méthode. La TextWriter.FormatProvider propriété, si ce n’est pas le cas 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
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour é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 fermeture est terminé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 UInt32.ToString méthode. La TextWriter.FormatProvider propriété, si ce n’est pas le cas 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
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour é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 StringBuilder.GetChunks méthode 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 fermeture est terminée.

IOException

Une erreur d’E/S se produit.

Remarques

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

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

Si value c’est nullle cas, 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)
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour é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 fermeture est terminée.

IOException

Une erreur d’E/S se produit.

Remarques

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

Voir aussi

• StreamWriter
• StringWriter
• IFormatProvider
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour é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 readOnlySpan<Char>. Méthode ToString .

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

Write(Object)

Source:

TextWriter.cs

Écrit la représentation textuelle d’un objet dans le flux de texte en appelant la ToString méthode 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 fermeture est terminée.

IOException

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 l’objet ToString 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 FormatProvider propriété, si ce n’est pas le cas 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
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour é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 fermeture est terminé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 Int64.ToString méthode. La TextWriter.FormatProvider propriété, si ce n’est pas le cas 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.

Guide pratique pour é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 fermeture est terminé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 Int32.ToString méthode. La TextWriter.FormatProvider propriété, si ce n’est pas le cas 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
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour é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 fermeture est terminé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 Double.ToString méthode. La TextWriter.FormatProvider propriété, si ce n’est pas le cas 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
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour é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 fermeture est terminé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écimaux) et les remplacer par NewLine.

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 , rien n’est nullécrit.

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

Voir aussi

• Write(Char[])
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour é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 fermeture est terminé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)
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour écrire du texte dans un fichier

Write(Boolean)

Source:

TextWriter.cs

Écrit la représentation textuelle d’une Boolean valeur 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 fermeture est terminé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 Boolean.ToString méthode.

Cette méthode génère l’une ou l’autre Boolean.TrueString des Boolean.FalseStringsorties .

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

Voir aussi

• StreamWriter
• StringWriter
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour é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 fermeture est terminé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 Single.ToString méthode. La TextWriter.FormatProvider propriété, si ce n’est pas le cas 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
• E/S de fichier et de flux
• Guide pratique pour lire du texte à partir d’un fichier
• Guide pratique pour écrire du texte dans un fichier