TextWriter.WriteLine Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Écrit des données dans le flux de texte, suivie d’un terminateur de ligne.
Surcharges
WriteLine(String, Object, Object) |
Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object, Object). |
WriteLine(Char[], Int32, Int32) |
Écrit un sous-narrateur de caractères dans le flux de texte, suivi d’une marque de fin de ligne. |
WriteLine(String, ReadOnlySpan<Object>) |
Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte à l’aide de la même sémantique que Format(String, ReadOnlySpan<Object>). |
WriteLine(String, Object[]) |
Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte à l’aide de la même sémantique que Format(String, Object). |
WriteLine(String, Object) |
Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object). |
WriteLine(UInt64) |
Écrit la représentation textuelle d’un entier non signé de 8 octets dans le flux de texte, suivie d’une marque de fin de ligne. |
WriteLine(String, Object, Object, Object) |
Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte à l’aide de la même sémantique que Format(String, Object). |
WriteLine(UInt32) |
Écrit la représentation textuelle d’un entier non signé de 4 octets dans le flux de texte, suivie d’une marque de fin de ligne. |
WriteLine(StringBuilder) |
Écrit la représentation textuelle d’un générateur de chaînes dans le flux de texte, suivie d’une marque de fin de ligne. |
WriteLine(String) |
Écrit une chaîne dans le flux de texte, suivie d’une marque de fin de ligne. |
WriteLine(Single) |
Écrit la représentation textuelle d’une valeur à virgule flottante de 4 octets dans le flux de texte, suivie d’une marque de fin de ligne. |
WriteLine(Double) |
Écrit la représentation textuelle d’une valeur à virgule flottante de 8 octets dans le flux de texte, suivie d’une marque de fin de ligne. |
WriteLine(Object) |
Écrit la représentation textuelle d’un objet dans le flux de texte, en appelant la méthode |
WriteLine(Int64) |
Écrit la représentation textuelle d’un entier signé de 8 octets dans le flux de texte, suivi d’un terminateur de ligne. |
WriteLine(Int32) |
Écrit la représentation textuelle d’un entier signé de 4 octets dans le flux de texte, suivi d’un terminateur de ligne. |
WriteLine(Decimal) |
Écrit la représentation textuelle d’une valeur décimale dans le flux de texte, suivie d’une marque de fin de ligne. |
WriteLine(Char[]) |
Écrit un tableau de caractères dans le flux de texte, suivi d’un terminateur de ligne. |
WriteLine(Char) |
Écrit un caractère dans le flux de texte, suivi d’une marque de fin de ligne. |
WriteLine(Boolean) |
Écrit la représentation textuelle d’une valeur |
WriteLine() |
Écrit un terminateur de ligne dans le flux de texte. |
WriteLine(ReadOnlySpan<Char>) |
Écrit la représentation textuelle d’une étendue de caractères dans le flux de texte, suivie d’un terminateur de ligne. |
WriteLine(String, Object, Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object, Object).
public:
virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void WriteLine (string format, object arg0, object arg1);
public virtual void WriteLine (string format, object? arg0, object? arg1);
abstract member WriteLine : string * obj * obj -> unit
override this.WriteLine : string * obj * obj -> unit
Public Overridable Sub WriteLine (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
est null
.
La TextWriter est fermée.
Une erreur d’E/S se produit.
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 NewLine.
Si un objet spécifié n’est pas référencé dans la chaîne de format, il est ignoré.
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(Char[], Int32, Int32)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit un sous-narrateur de caractères dans le flux de texte, suivi d’une marque de fin de ligne.
public:
virtual void WriteLine(cli::array <char> ^ buffer, int index, int count);
public virtual void WriteLine (char[] buffer, int index, int count);
abstract member WriteLine : char[] * int * int -> unit
override this.WriteLine : char[] * int * int -> unit
Public Overridable Sub WriteLine (buffer As Char(), index As Integer, count As Integer)
Paramètres
- buffer
- Char[]
Tableau de caractères à partir duquel les données sont lues.
- index
- Int32
Position de caractère dans buffer
à laquelle commencer la lecture des données.
- count
- Int32
Nombre maximal de caractères à écrire.
Exceptions
La longueur de la mémoire tampon moins index
est inférieure à count
.
Le paramètre buffer
est null
.
index
ou count
est négatif.
La TextWriter est fermée.
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 à appeler la méthode Write(Char[]) suivie de WriteLine pour chaque caractère dans buffer
entre index
et (index
+ count
).
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(String, ReadOnlySpan<Object>)
Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte à l’aide de la même sémantique que Format(String, ReadOnlySpan<Object>).
public:
virtual void WriteLine(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public virtual void WriteLine (string format, scoped ReadOnlySpan<object?> arg);
abstract member WriteLine : string * ReadOnlySpan<obj> -> unit
override this.WriteLine : string * ReadOnlySpan<obj> -> unit
Public Overridable Sub WriteLine (format As String, arg As ReadOnlySpan(Of Object))
Paramètres
- format
- String
Chaîne de format composite.
- arg
- ReadOnlySpan<Object>
Étendue d’objet qui contient zéro ou plusieurs objets à mettre en forme et écrire.
S’applique à
WriteLine(String, Object[])
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte à l’aide de la même sémantique que Format(String, Object).
public:
virtual void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void WriteLine (string format, params object[] arg);
public virtual void WriteLine (string format, params object?[] arg);
abstract member WriteLine : string * obj[] -> unit
override this.WriteLine : string * obj[] -> unit
Public Overridable Sub WriteLine (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
Une chaîne ou un objet est transmis en tant que null
.
La TextWriter est fermée.
Une erreur d’E/S se produit.
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 NewLine.
Si un objet spécifié n’est pas référencé dans la chaîne de format, il est ignoré.
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(String, Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte, en utilisant la même sémantique que la méthode Format(String, Object).
public:
virtual void WriteLine(System::String ^ format, System::Object ^ arg0);
public virtual void WriteLine (string format, object arg0);
public virtual void WriteLine (string format, object? arg0);
abstract member WriteLine : string * obj -> unit
override this.WriteLine : string * obj -> unit
Public Overridable Sub WriteLine (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
est null
.
La TextWriter est fermée.
Une erreur d’E/S se produit.
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 NewLine.
Si un objet spécifié n’est pas référencé dans la chaîne de format, il est ignoré.
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(UInt64)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- 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, suivie d’une marque de fin de ligne.
public:
virtual void WriteLine(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void WriteLine (ulong value);
[<System.CLSCompliant(false)>]
abstract member WriteLine : uint64 -> unit
override this.WriteLine : uint64 -> unit
Public Overridable Sub WriteLine (value As ULong)
Paramètres
- value
- UInt64
Entier non signé de 8 octets à écrire.
- Attributs
Exceptions
La TextWriter est fermée.
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é FormatProvider, si elle n’est pas null
, spécifie la mise en forme spécifique à la culture.
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(String, Object, Object, Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit une chaîne mise en forme et une nouvelle ligne dans le flux de texte à l’aide de la même sémantique que Format(String, Object).
public:
virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public virtual void WriteLine (string format, object arg0, object arg1, object arg2);
public virtual void WriteLine (string format, object? arg0, object? arg1, object? arg2);
abstract member WriteLine : string * obj * obj * obj -> unit
override this.WriteLine : string * obj * obj * obj -> unit
Public Overridable Sub WriteLine (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
est null
.
La TextWriter est fermée.
Une erreur d’E/S se produit.
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 NewLine.
Si un objet spécifié n’est pas référencé dans la chaîne de format, il est ignoré.
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(UInt32)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- 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, suivie d’une marque de fin de ligne.
public:
virtual void WriteLine(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void WriteLine (uint value);
[<System.CLSCompliant(false)>]
abstract member WriteLine : uint32 -> unit
override this.WriteLine : uint32 -> unit
Public Overridable Sub WriteLine (value As UInteger)
Paramètres
- value
- UInt32
Entier non signé de 4 octets à écrire.
- Attributs
Exceptions
La TextWriter est fermée.
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é FormatProvider, si elle n’est pas null
, spécifie la mise en forme spécifique à la culture.
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(StringBuilder)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation textuelle d’un générateur de chaînes dans le flux de texte, suivie d’une marque de fin de ligne.
public:
virtual void WriteLine(System::Text::StringBuilder ^ value);
public virtual void WriteLine (System.Text.StringBuilder? value);
abstract member WriteLine : System.Text.StringBuilder -> unit
override this.WriteLine : System.Text.StringBuilder -> unit
Public Overridable Sub WriteLine (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
La représentation textuelle de la valeur spécifiée est produite en appelant la méthode StringBuilder.ToString.
Le terminateur de ligne est défini par le champ CoreNewLine.
Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.
S’applique à
WriteLine(String)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit une chaîne dans le flux de texte, suivie d’une marque de fin de ligne.
public:
virtual void WriteLine(System::String ^ value);
public virtual void WriteLine (string value);
public virtual void WriteLine (string? value);
abstract member WriteLine : string -> unit
override this.WriteLine : string -> unit
Public Overridable Sub WriteLine (value As String)
Paramètres
- value
- String
Chaîne à écrire. Si value
est null
, seul le terminateur de ligne est écrit.
Exceptions
La TextWriter est fermée.
Une erreur d’E/S se produit.
Remarques
Cette surcharge équivaut à la surcharge Write(Char[]).
Le terminateur de ligne est défini par le champ CoreNewLine.
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.
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
S’applique à
WriteLine(Single)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation textuelle d’une valeur à virgule flottante de 4 octets dans le flux de texte, suivie d’une marque de fin de ligne.
public:
virtual void WriteLine(float value);
public virtual void WriteLine (float value);
abstract member WriteLine : single -> unit
override this.WriteLine : single -> unit
Public Overridable Sub WriteLine (value As Single)
Paramètres
- value
- Single
Valeur à virgule flottante de 4 octets à écrire.
Exceptions
La TextWriter est fermée.
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. Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(Double)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation textuelle d’une valeur à virgule flottante de 8 octets dans le flux de texte, suivie d’une marque de fin de ligne.
public:
virtual void WriteLine(double value);
public virtual void WriteLine (double value);
abstract member WriteLine : double -> unit
override this.WriteLine : double -> unit
Public Overridable Sub WriteLine (value As Double)
Paramètres
- value
- Double
Valeur à virgule flottante de 8 octets à écrire.
Exceptions
La TextWriter est fermée.
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. Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(Object)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- 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, suivie d’un terminateur de ligne.
public:
virtual void WriteLine(System::Object ^ value);
public virtual void WriteLine (object value);
public virtual void WriteLine (object? value);
abstract member WriteLine : obj -> unit
override this.WriteLine : obj -> unit
Public Overridable Sub WriteLine (value As Object)
Paramètres
- value
- Object
Objet à écrire. Si value
est null
, seul le terminateur de ligne est écrit.
Exceptions
La TextWriter est fermée.
Une erreur d’E/S se produit.
Remarques
Cette surcharge équivaut à la surcharge Write(String, Object). La propriété FormatProvider, si elle n’est pas null
, spécifie la mise en forme spécifique à la culture.
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(Int64)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation textuelle d’un entier signé de 8 octets dans le flux de texte, suivi d’un terminateur de ligne.
public:
virtual void WriteLine(long value);
public virtual void WriteLine (long value);
abstract member WriteLine : int64 -> unit
override this.WriteLine : int64 -> unit
Public Overridable Sub WriteLine (value As Long)
Paramètres
- value
- Int64
Entier signé de 8 octets à écrire.
Exceptions
La TextWriter est fermée.
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.
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(Int32)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation textuelle d’un entier signé de 4 octets dans le flux de texte, suivi d’un terminateur de ligne.
public:
virtual void WriteLine(int value);
public virtual void WriteLine (int value);
abstract member WriteLine : int -> unit
override this.WriteLine : int -> unit
Public Overridable Sub WriteLine (value As Integer)
Paramètres
- value
- Int32
Entier signé de 4 octets à écrire.
Exceptions
La TextWriter est fermée.
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.
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(Decimal)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation textuelle d’une valeur décimale dans le flux de texte, suivie d’une marque de fin de ligne.
public:
virtual void WriteLine(System::Decimal value);
public virtual void WriteLine (decimal value);
abstract member WriteLine : decimal -> unit
override this.WriteLine : decimal -> unit
Public Overridable Sub WriteLine (value As Decimal)
Paramètres
- value
- Decimal
Valeur décimale à écrire.
Exceptions
La TextWriter est fermée.
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. Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(Char[])
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit un tableau de caractères dans le flux de texte, suivi d’un terminateur de ligne.
public:
virtual void WriteLine(cli::array <char> ^ buffer);
public virtual void WriteLine (char[] buffer);
public virtual void WriteLine (char[]? buffer);
abstract member WriteLine : char[] -> unit
override this.WriteLine : char[] -> unit
Public Overridable Sub WriteLine (buffer As Char())
Paramètres
- buffer
- Char[]
Tableau de caractères à partir duquel les données sont lues.
Exceptions
La TextWriter est fermée.
Une erreur d’E/S se produit.
Remarques
Tous les caractères de buffer
sont écrits dans le flux sous-jacent. Si le tableau de caractères est null
, seul le terminateur de ligne est écrit.
Cette surcharge équivaut à Write(Char[]) suivie de WriteLine().
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(Char)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit un caractère dans le flux de texte, suivi d’une marque de fin de ligne.
public:
virtual void WriteLine(char value);
public virtual void WriteLine (char value);
abstract member WriteLine : char -> unit
override this.WriteLine : char -> unit
Public Overridable Sub WriteLine (value As Char)
Paramètres
- value
- Char
Caractère à écrire dans le flux de texte.
Exceptions
La TextWriter est fermée.
Une erreur d’E/S se produit.
Remarques
Cette surcharge équivaut à Write(Char) suivie de WriteLine().
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(Boolean)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation textuelle d’une valeur Boolean
dans le flux de texte, suivie d’une marque de fin de ligne.
public:
virtual void WriteLine(bool value);
public virtual void WriteLine (bool value);
abstract member WriteLine : bool -> unit
override this.WriteLine : bool -> unit
Public Overridable Sub WriteLine (value As Boolean)
Paramètres
- value
- Boolean
Valeur Boolean
à écrire.
Exceptions
La TextWriter est fermée.
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.
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine()
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit un terminateur de ligne dans le flux de texte.
public:
virtual void WriteLine();
public virtual void WriteLine ();
abstract member WriteLine : unit -> unit
override this.WriteLine : unit -> unit
Public Overridable Sub WriteLine ()
Exceptions
La TextWriter est fermée.
Une erreur d’E/S se produit.
Remarques
Le terminateur de ligne est défini par le champ CoreNewLine.
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
S’applique à
WriteLine(ReadOnlySpan<Char>)
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
- Source:
- TextWriter.cs
Écrit la représentation textuelle d’une étendue de caractères dans le flux de texte, suivie d’un terminateur de ligne.
public:
virtual void WriteLine(ReadOnlySpan<char> buffer);
public virtual void WriteLine (ReadOnlySpan<char> buffer);
abstract member WriteLine : ReadOnlySpan<char> -> unit
override this.WriteLine : ReadOnlySpan<char> -> unit
Public Overridable Sub WriteLine (buffer As ReadOnlySpan(Of Char))
Paramètres
- buffer
- ReadOnlySpan<Char>
Valeur d’étendue de caractères à écrire dans le flux de texte.
Remarques
La représentation textuelle de la valeur spécifiée est produite en appelant le ReadOnlySpan<Char>. Méthode toString.
Le terminateur de ligne est défini par le champ CoreNewLine.
Pour obtenir la liste des tâches d’E/S courantes, consultez tâches d’E/S courantes.