Lire en anglais

Partager via

Console.WriteLine Méthode

  • Référence

Définition

Espace de noms:
System
Assembly:
System.Console.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Écrit les données spécifiées, suivies du point de terminaison de ligne actuel, dans le flux de sortie standard.

Surcharges

WriteLine(String, Object, Object)

Écrit la représentation textuelle des objets spécifiés, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard à l’aide des informations de format spécifiées.
WriteLine(String)

Écrit la valeur de chaîne spécifiée, suivie de la marque de fin de ligne actuelle, dans le flux de sortie standard.
WriteLine(Char[], Int32, Int32)

Écrit le sous-narrateur de caractères Unicode spécifié, suivi du point de terminaison de ligne actuel, dans le flux de sortie standard.
WriteLine(String, ReadOnlySpan<Object>)

Écrit la représentation textuelle de l’étendue spécifiée d’objets, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard à l’aide des informations de format spécifiées.
WriteLine(String, Object[])

Écrit la représentation textuelle du tableau d’objets spécifié, suivi du point de terminaison de ligne actuel, dans le flux de sortie standard à l’aide des informations de format spécifiées.
WriteLine(String, Object)

Écrit la représentation textuelle de l’objet spécifié, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard à l’aide des informations de format spécifiées.
WriteLine(UInt64)

Écrit la représentation textuelle de la valeur entière non signée 64 bits spécifiée, suivie de la marque de fin de ligne actuelle, dans le flux de sortie standard.
WriteLine(UInt32)

Écrit la représentation textuelle de la valeur entière non signée 32 bits spécifiée, suivie du terminateur de ligne actuel, dans le flux de sortie standard.
WriteLine(Single)

Écrit la représentation textuelle de la valeur à virgule flottante simple précision spécifiée, suivie du terminateur de ligne actuel, dans le flux de sortie standard.
WriteLine(Double)

Écrit la représentation textuelle de la valeur à virgule flottante double précision spécifiée, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard.
WriteLine(Int64)

Écrit la représentation textuelle de la valeur entière signée 64 bits spécifiée, suivie du terminateur de ligne actuel, dans le flux de sortie standard.
WriteLine(Int32)

Écrit la représentation textuelle de la valeur entière signée 32 bits spécifiée, suivie du terminateur de ligne actuel, dans le flux de sortie standard.
WriteLine(Decimal)

Écrit la représentation textuelle de la valeur Decimal spécifiée, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard.
WriteLine(Char[])

Écrit le tableau spécifié de caractères Unicode, suivi du point de terminaison de ligne actuel, dans le flux de sortie standard.
WriteLine(Char)

Écrit le caractère Unicode spécifié, suivi de l’indicateur de fin de ligne actuel, valeur dans le flux de sortie standard.
WriteLine(Boolean)

Écrit la représentation textuelle de la valeur booléenne spécifiée, suivie de la marque de fin de ligne actuelle, dans le flux de sortie standard.
WriteLine()

Écrit le terminateur de ligne actuel dans le flux de sortie standard.
WriteLine(String, Object, Object, Object)

Écrit la représentation textuelle des objets spécifiés, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard à l’aide des informations de format spécifiées.
WriteLine(Object)

Écrit la représentation textuelle de l’objet spécifié, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard.
WriteLine(String, Object, Object, Object, Object)

Écrit la représentation textuelle des objets spécifiés et de la liste des paramètres de longueur variable, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard à l’aide des informations de format spécifiées.

Remarques

Le terminateur de ligne par défaut est une chaîne dont la valeur est un retour chariot suivi d’un flux de ligne («\r\n» en C#, ou vbCrLf en Visual Basic). Vous pouvez modifier la marque de fin de ligne en définissant la propriété TextWriter.NewLine de la propriété Out sur une autre chaîne.

WriteLine(String, Object, Object)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit la représentation textuelle des objets spécifiés, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard à l’aide des informations de format spécifiées.

C# 
public static void WriteLine (string format, object? arg0, object? arg1);
C# 
public static void WriteLine (string format, object arg0, object arg1);

Paramètres

format
String

Chaîne de format composite.

arg0
Object

Premier objet à écrire à l’aide de format.

arg1
Object

Deuxième objet à écrire à l’aide de format.

Exceptions

IOException

Une erreur d’E/S s’est produite.

ArgumentNullException

format est null.

FormatException

La spécification de format dans format n’est pas valide.

Exemples

L’exemple suivant illustre les spécificateurs de mise en forme standard pour les nombres, les dates et les énumérations.

C# 
// This code example demonstrates the Console.WriteLine() method.
// Formatting for this example uses the "en-US" culture.

using System;
class Sample
{
    enum Color {Yellow = 1, Blue, Green};
    static DateTime thisDate = DateTime.Now;

    public static void Main()
    {
        Console.Clear();

        // Format a negative integer or floating-point number in various ways.
        Console.WriteLine("Standard Numeric Format Specifiers");
        Console.WriteLine(
            "(C) Currency: . . . . . . . . {0:C}\n" +
            "(D) Decimal:. . . . . . . . . {0:D}\n" +
            "(E) Scientific: . . . . . . . {1:E}\n" +
            "(F) Fixed point:. . . . . . . {1:F}\n" +
            "(G) General:. . . . . . . . . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(N) Number: . . . . . . . . . {0:N}\n" +
            "(P) Percent:. . . . . . . . . {1:P}\n" +
            "(R) Round-trip: . . . . . . . {1:R}\n" +
            "(X) Hexadecimal:. . . . . . . {0:X}\n",
            -123, -123.45f);

        // Format the current date in various ways.
        Console.WriteLine("Standard DateTime Format Specifiers");
        Console.WriteLine(
            "(d) Short date: . . . . . . . {0:d}\n" +
            "(D) Long date:. . . . . . . . {0:D}\n" +
            "(t) Short time: . . . . . . . {0:t}\n" +
            "(T) Long time:. . . . . . . . {0:T}\n" +
            "(f) Full date/short time: . . {0:f}\n" +
            "(F) Full date/long time:. . . {0:F}\n" +
            "(g) General date/short time:. {0:g}\n" +
            "(G) General date/long time: . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(M) Month:. . . . . . . . . . {0:M}\n" +
            "(R) RFC1123:. . . . . . . . . {0:R}\n" +
            "(s) Sortable: . . . . . . . . {0:s}\n" +
            "(u) Universal sortable: . . . {0:u} (invariant)\n" +
            "(U) Universal full date/time: {0:U}\n" +
            "(Y) Year: . . . . . . . . . . {0:Y}\n",
            thisDate);

        // Format a Color enumeration value in various ways.
        Console.WriteLine("Standard Enumeration Format Specifiers");
        Console.WriteLine(
            "(G) General:. . . . . . . . . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(F) Flags:. . . . . . . . . . {0:F} (flags or integer)\n" +
            "(D) Decimal number: . . . . . {0:D}\n" +
            "(X) Hexadecimal:. . . . . . . {0:X}\n",
            Color.Green);
    }
}
/*
This code example produces the following results:

Standard Numeric Format Specifiers
(C) Currency: . . . . . . . . ($123.00)
(D) Decimal:. . . . . . . . . -123
(E) Scientific: . . . . . . . -1.234500E+002
(F) Fixed point:. . . . . . . -123.45
(G) General:. . . . . . . . . -123
    (default):. . . . . . . . -123 (default = 'G')
(N) Number: . . . . . . . . . -123.00
(P) Percent:. . . . . . . . . -12,345.00 %
(R) Round-trip: . . . . . . . -123.45
(X) Hexadecimal:. . . . . . . FFFFFF85

Standard DateTime Format Specifiers
(d) Short date: . . . . . . . 6/26/2004
(D) Long date:. . . . . . . . Saturday, June 26, 2004
(t) Short time: . . . . . . . 8:11 PM
(T) Long time:. . . . . . . . 8:11:04 PM
(f) Full date/short time: . . Saturday, June 26, 2004 8:11 PM
(F) Full date/long time:. . . Saturday, June 26, 2004 8:11:04 PM
(g) General date/short time:. 6/26/2004 8:11 PM
(G) General date/long time: . 6/26/2004 8:11:04 PM
    (default):. . . . . . . . 6/26/2004 8:11:04 PM (default = 'G')
(M) Month:. . . . . . . . . . June 26
(R) RFC1123:. . . . . . . . . Sat, 26 Jun 2004 20:11:04 GMT
(s) Sortable: . . . . . . . . 2004-06-26T20:11:04
(u) Universal sortable: . . . 2004-06-26 20:11:04Z (invariant)
(U) Universal full date/time: Sunday, June 27, 2004 3:11:04 AM
(Y) Year: . . . . . . . . . . June, 2004

Standard Enumeration Format Specifiers
(G) General:. . . . . . . . . Green
    (default):. . . . . . . . Green (default = 'G')
(F) Flags:. . . . . . . . . . Green (flags or integer)
(D) Decimal number: . . . . . 3
(X) Hexadecimal:. . . . . . . 00000003

*/

L’exemple suivant est une calculatrice de pourboires qui calcule un pourboire de 18% et utilise la méthode WriteLine pour afficher le montant des frais d’origine, le montant du pourboire et le montant total. L’exemple est une application console qui oblige l’utilisateur à fournir la quantité de frais d’origine en tant que paramètre de ligne de commande.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Remarques

Cette méthode utilise la fonctionnalité de mise en forme composite de .NET pour convertir la valeur d’un objet en sa représentation textuelle et incorporer cette représentation dans une chaîne. La chaîne résultante est écrite dans le flux de sortie.

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 textuelle de la valeur de l’objet correspondant.

La syntaxe d’un élément de format est {index[,alignement][:formatString]}, qui spécifie un index obligatoire, la longueur facultative et l’alignement du texte mis en forme et une chaîne facultative de caractères spécificateurs de format qui régissent la façon dont la valeur de l’objet correspondant est mise en forme.

.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 marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(String)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit la valeur de chaîne spécifiée, suivie de la marque de fin de ligne actuelle, dans le flux de sortie standard.

C# 
public static void WriteLine (string? value);
C# 
public static void WriteLine (string value);

Paramètres

value
String

Valeur à écrire.

Exceptions

IOException

Une erreur d’E/S s’est produite.

Exemples

L’exemple montre comment modifier la marque de fin de ligne de sa valeur par défaut «\r\n» ou vbCrLf «\r\n\r\n» ou vbCrLf + vbCrLf. Il appelle ensuite les méthodes WriteLine() et WriteLine(String) pour afficher la sortie dans la console.

C# 
string[] lines = { "This is the first line.",
                   "This is the second line." };
// Output the lines using the default newline sequence.
Console.WriteLine("With the default new line characters:");
Console.WriteLine();
foreach (string line in lines)
   Console.WriteLine(line);

Console.WriteLine();

// Redefine the newline characters to double space.
Console.Out.NewLine = "\r\n\r\n";
// Output the lines using the new newline sequence.
Console.WriteLine("With redefined new line characters:");
Console.WriteLine();
foreach (string line in lines)
   Console.WriteLine(line);

// The example displays the following output:
//       With the default new line characters:
//
//       This is the first line.
//       This is the second line.
//
//       With redefined new line characters:
//
//
//
//       This is the first line.
//
//       This is the second line.

Remarques

Si la valeur est null, seul le terminateur de ligne est écrit dans le flux de sortie standard.

Pour plus d’informations sur la marque de fin de ligne, consultez la section Notes de la méthode WriteLine().

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Char[], Int32, Int32)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit le sous-narrateur de caractères Unicode spécifié, suivi du point de terminaison de ligne actuel, dans le flux de sortie standard.

C# 
public static void WriteLine (char[] buffer, int index, int count);

Paramètres

buffer
Char[]

Tableau de caractères Unicode.

index
Int32

Position de départ dans buffer.

count
Int32

Nombre de caractères à écrire.

Exceptions

ArgumentNullException

buffer est null.

ArgumentOutOfRangeException

index ou count est inférieur à zéro.

ArgumentException

index plus count spécifier une position qui n’est pas comprise dans buffer.

IOException

Une erreur d’E/S s’est produite.

Remarques

Cette méthode écrit count caractères commençant à la position index de buffer dans le flux de sortie standard.

Pour plus d’informations sur la marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(String, ReadOnlySpan<Object>)

Écrit la représentation textuelle de l’étendue spécifiée d’objets, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard à l’aide des informations de format spécifiées.

C# 
public static void WriteLine (string format, scoped ReadOnlySpan<object?> arg);

Paramètres

format
String

Chaîne de format composite.

arg
ReadOnlySpan<Object>

Étendue d’objets à écrire à l’aide du format.

S’applique à

.NET 9
Produit Versions
.NET 9

WriteLine(String, Object[])

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit la représentation textuelle du tableau d’objets spécifié, suivi du point de terminaison de ligne actuel, dans le flux de sortie standard à l’aide des informations de format spécifiées.

C# 
public static void WriteLine (string format, params object?[]? arg);
C# 
public static void WriteLine (string format, params object[] arg);

Paramètres

format
String

Chaîne de format composite.

arg
Object[]

Tableau d’objets à écrire à l’aide de format.

Exceptions

IOException

Une erreur d’E/S s’est produite.

ArgumentNullException

format ou arg est null.

FormatException

La spécification de format dans format n’est pas valide.

Exemples

L’exemple suivant illustre les spécificateurs de mise en forme standard pour les nombres, les dates et les énumérations.

C# 
// This code example demonstrates the Console.WriteLine() method.
// Formatting for this example uses the "en-US" culture.

using System;
class Sample
{
    enum Color {Yellow = 1, Blue, Green};
    static DateTime thisDate = DateTime.Now;

    public static void Main()
    {
        Console.Clear();

        // Format a negative integer or floating-point number in various ways.
        Console.WriteLine("Standard Numeric Format Specifiers");
        Console.WriteLine(
            "(C) Currency: . . . . . . . . {0:C}\n" +
            "(D) Decimal:. . . . . . . . . {0:D}\n" +
            "(E) Scientific: . . . . . . . {1:E}\n" +
            "(F) Fixed point:. . . . . . . {1:F}\n" +
            "(G) General:. . . . . . . . . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(N) Number: . . . . . . . . . {0:N}\n" +
            "(P) Percent:. . . . . . . . . {1:P}\n" +
            "(R) Round-trip: . . . . . . . {1:R}\n" +
            "(X) Hexadecimal:. . . . . . . {0:X}\n",
            -123, -123.45f);

        // Format the current date in various ways.
        Console.WriteLine("Standard DateTime Format Specifiers");
        Console.WriteLine(
            "(d) Short date: . . . . . . . {0:d}\n" +
            "(D) Long date:. . . . . . . . {0:D}\n" +
            "(t) Short time: . . . . . . . {0:t}\n" +
            "(T) Long time:. . . . . . . . {0:T}\n" +
            "(f) Full date/short time: . . {0:f}\n" +
            "(F) Full date/long time:. . . {0:F}\n" +
            "(g) General date/short time:. {0:g}\n" +
            "(G) General date/long time: . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(M) Month:. . . . . . . . . . {0:M}\n" +
            "(R) RFC1123:. . . . . . . . . {0:R}\n" +
            "(s) Sortable: . . . . . . . . {0:s}\n" +
            "(u) Universal sortable: . . . {0:u} (invariant)\n" +
            "(U) Universal full date/time: {0:U}\n" +
            "(Y) Year: . . . . . . . . . . {0:Y}\n",
            thisDate);

        // Format a Color enumeration value in various ways.
        Console.WriteLine("Standard Enumeration Format Specifiers");
        Console.WriteLine(
            "(G) General:. . . . . . . . . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(F) Flags:. . . . . . . . . . {0:F} (flags or integer)\n" +
            "(D) Decimal number: . . . . . {0:D}\n" +
            "(X) Hexadecimal:. . . . . . . {0:X}\n",
            Color.Green);
    }
}
/*
This code example produces the following results:

Standard Numeric Format Specifiers
(C) Currency: . . . . . . . . ($123.00)
(D) Decimal:. . . . . . . . . -123
(E) Scientific: . . . . . . . -1.234500E+002
(F) Fixed point:. . . . . . . -123.45
(G) General:. . . . . . . . . -123
    (default):. . . . . . . . -123 (default = 'G')
(N) Number: . . . . . . . . . -123.00
(P) Percent:. . . . . . . . . -12,345.00 %
(R) Round-trip: . . . . . . . -123.45
(X) Hexadecimal:. . . . . . . FFFFFF85

Standard DateTime Format Specifiers
(d) Short date: . . . . . . . 6/26/2004
(D) Long date:. . . . . . . . Saturday, June 26, 2004
(t) Short time: . . . . . . . 8:11 PM
(T) Long time:. . . . . . . . 8:11:04 PM
(f) Full date/short time: . . Saturday, June 26, 2004 8:11 PM
(F) Full date/long time:. . . Saturday, June 26, 2004 8:11:04 PM
(g) General date/short time:. 6/26/2004 8:11 PM
(G) General date/long time: . 6/26/2004 8:11:04 PM
    (default):. . . . . . . . 6/26/2004 8:11:04 PM (default = 'G')
(M) Month:. . . . . . . . . . June 26
(R) RFC1123:. . . . . . . . . Sat, 26 Jun 2004 20:11:04 GMT
(s) Sortable: . . . . . . . . 2004-06-26T20:11:04
(u) Universal sortable: . . . 2004-06-26 20:11:04Z (invariant)
(U) Universal full date/time: Sunday, June 27, 2004 3:11:04 AM
(Y) Year: . . . . . . . . . . June, 2004

Standard Enumeration Format Specifiers
(G) General:. . . . . . . . . Green
    (default):. . . . . . . . Green (default = 'G')
(F) Flags:. . . . . . . . . . Green (flags or integer)
(D) Decimal number: . . . . . 3
(X) Hexadecimal:. . . . . . . 00000003

*/

L’exemple suivant est une calculatrice de pourboires qui calcule un pourboire de 18% et utilise la méthode WriteLine pour afficher le montant des frais d’origine, le montant du pourboire et le montant total. L’exemple est une application console qui oblige l’utilisateur à fournir la quantité de frais d’origine en tant que paramètre de ligne de commande.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Remarques

Cette méthode utilise la fonctionnalité de mise en forme composite de .NET pour convertir la valeur d’un objet en sa représentation textuelle et incorporer cette représentation dans une chaîne. La chaîne résultante est écrite dans le flux de sortie.

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 textuelle de la valeur de l’objet correspondant.

La syntaxe d’un élément de format est {index[,alignement][:formatString]}, qui spécifie un index obligatoire, la longueur facultative et l’alignement du texte mis en forme et une chaîne facultative de caractères spécificateurs de format qui régissent la façon dont la valeur de l’objet correspondant est mise en forme.

.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 marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Notes pour les appelants

Cette méthode n’est pas appelée par le code C++. Le compilateur C++ résout les appels à System.Console.WriteLine qui incluent une chaîne et une liste de quatre paramètres d’objet ou plus en tant qu’appel à WriteLine(String, Object, Object, Object, Object). Il résout les appels à System.Console.WriteLine qui incluent une chaîne et un tableau d’objets comme appel à WriteLine(String, Object).

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(String, Object)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit la représentation textuelle de l’objet spécifié, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard à l’aide des informations de format spécifiées.

C# 
public static void WriteLine (string format, object? arg0);
C# 
public static void WriteLine (string format, object arg0);

Paramètres

format
String

Chaîne de format composite.

arg0
Object

Objet à écrire à l’aide de format.

Exceptions

IOException

Une erreur d’E/S s’est produite.

ArgumentNullException

format est null.

FormatException

La spécification de format dans format n’est pas valide.

Exemples

L’exemple suivant appelle la méthode WriteLine(String, Object) pour afficher cinq valeurs Boolean générées de manière aléatoire.

C# 
Random rnd = new Random();
// Generate five random Boolean values.
for (int ctr = 1; ctr <= 5; ctr++) {
   bool bln = rnd.Next(0, 2) == 1;
   Console.WriteLine($"True or False: {bln}");
}

// The example displays an output similar to the following:
//       True or False: False
//       True or False: True
//       True or False: False
//       True or False: False
//       True or False: True

L’exemple suivant appelle la méthode WriteLine(String, Object) pour afficher la date actuelle. Notez que l’élément de format dans l’argument format utilise la chaîne de format de date et d’heure « D » chaîne de format de date et d’heure standard pour afficher la date dans le format de date long de la culture actuelle.

C# 
using System;

public class Example
{
   public static void Main()
   {
      Console.WriteLine("Today's date: {0:D}", DateTime.Now);
   }
}
// The example displays output like the following:
//       Today's date: Monday, April 1, 2019

Remarques

Cette méthode utilise la fonctionnalité de mise en forme composite de .NET pour convertir la valeur d’un objet en sa représentation textuelle et incorporer cette représentation dans une chaîne. La chaîne résultante est écrite dans le flux de sortie.

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 textuelle de la valeur de l’objet correspondant.

La syntaxe d’un élément de format est {index[,alignement][:formatString]}, qui spécifie un index obligatoire, la longueur facultative et l’alignement du texte mis en forme et une chaîne facultative de caractères spécificateurs de format qui régissent la façon dont la valeur de l’objet correspondant est mise en forme.

.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 marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(UInt64)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Important

Cette API n’est pas conforme CLS.

Écrit la représentation textuelle de la valeur entière non signée 64 bits spécifiée, suivie de la marque de fin de ligne actuelle, dans le flux de sortie standard.

C# 
[System.CLSCompliant(false)]
public static void WriteLine (ulong value);

Paramètres

value
UInt64

Valeur à écrire.

Attributs
CLSCompliantAttribute

Exceptions

IOException

Une erreur d’E/S s’est produite.

Exemples

L’exemple suivant est une calculatrice de pourboires qui calcule un pourboire de 18% et utilise la méthode WriteLine pour afficher le montant des frais d’origine, le montant du pourboire et le montant total. L’exemple est une application console qui oblige l’utilisateur à fournir la quantité de frais d’origine en tant que paramètre de ligne de commande.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Remarques

La représentation textuelle de value est produite en appelant la méthode UInt64.ToString.

Pour plus d’informations sur la marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(UInt32)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Important

Cette API n’est pas conforme CLS.

Écrit la représentation textuelle de la valeur entière non signée 32 bits spécifiée, suivie du terminateur de ligne actuel, dans le flux de sortie standard.

C# 
[System.CLSCompliant(false)]
public static void WriteLine (uint value);

Paramètres

value
UInt32

Valeur à écrire.

Attributs
CLSCompliantAttribute

Exceptions

IOException

Une erreur d’E/S s’est produite.

Exemples

L’exemple suivant est une calculatrice de pourboires qui calcule un pourboire de 18% et utilise la méthode WriteLine pour afficher le montant des frais d’origine, le montant du pourboire et le montant total. L’exemple est une application console qui oblige l’utilisateur à fournir la quantité de frais d’origine en tant que paramètre de ligne de commande.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Remarques

La représentation textuelle de value est produite en appelant la méthode UInt32.ToString.

Pour plus d’informations sur la marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Single)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit la représentation textuelle de la valeur à virgule flottante simple précision spécifiée, suivie du terminateur de ligne actuel, dans le flux de sortie standard.

C# 
public static void WriteLine (float value);

Paramètres

value
Single

Valeur à écrire.

Exceptions

IOException

Une erreur d’E/S s’est produite.

Exemples

L’exemple suivant est une calculatrice de pourboires qui calcule un pourboire de 18% et utilise la méthode WriteLine pour afficher le montant des frais d’origine, le montant du pourboire et le montant total. L’exemple est une application console qui oblige l’utilisateur à fournir la quantité de frais d’origine en tant que paramètre de ligne de commande.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Remarques

La représentation textuelle de value est produite en appelant la méthode Single.ToString.

Pour plus d’informations sur la marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Double)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit la représentation textuelle de la valeur à virgule flottante double précision spécifiée, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard.

C# 
public static void WriteLine (double value);

Paramètres

value
Double

Valeur à écrire.

Exceptions

IOException

Une erreur d’E/S s’est produite.

Exemples

L’exemple suivant est une calculatrice de pourboires qui calcule un pourboire de 18% et utilise la méthode WriteLine pour afficher le montant des frais d’origine, le montant du pourboire et le montant total. L’exemple est une application console qui oblige l’utilisateur à fournir la quantité de frais d’origine en tant que paramètre de ligne de commande.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Remarques

La représentation textuelle de value est produite en appelant la méthode Double.ToString.

Pour plus d’informations sur la marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Int64)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit la représentation textuelle de la valeur entière signée 64 bits spécifiée, suivie du terminateur de ligne actuel, dans le flux de sortie standard.

C# 
public static void WriteLine (long value);

Paramètres

value
Int64

Valeur à écrire.

Exceptions

IOException

Une erreur d’E/S s’est produite.

Exemples

L’exemple suivant est une calculatrice de pourboires qui calcule un pourboire de 18% et utilise la méthode WriteLine pour afficher le montant des frais d’origine, le montant du pourboire et le montant total. L’exemple est une application console qui oblige l’utilisateur à fournir la quantité de frais d’origine en tant que paramètre de ligne de commande.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Remarques

La représentation textuelle de value est produite en appelant la méthode Int64.ToString.

Pour plus d’informations sur la marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Int32)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit la représentation textuelle de la valeur entière signée 32 bits spécifiée, suivie du terminateur de ligne actuel, dans le flux de sortie standard.

C# 
public static void WriteLine (int value);

Paramètres

value
Int32

Valeur à écrire.

Exceptions

IOException

Une erreur d’E/S s’est produite.

Exemples

L’exemple suivant est une calculatrice de pourboires qui calcule un pourboire de 18% et utilise la méthode WriteLine pour afficher le montant des frais d’origine, le montant du pourboire et le montant total. L’exemple est une application console qui oblige l’utilisateur à fournir la quantité de frais d’origine en tant que paramètre de ligne de commande.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Remarques

La représentation textuelle de value est produite en appelant la méthode Int32.ToString.

Pour plus d’informations sur la marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Decimal)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit la représentation textuelle de la valeur Decimal spécifiée, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard.

C# 
public static void WriteLine (decimal value);

Paramètres

value
Decimal

Valeur à écrire.

Exceptions

IOException

Une erreur d’E/S s’est produite.

Exemples

L’exemple suivant est une calculatrice de pourboires qui calcule un pourboire de 18% et utilise la méthode WriteLine pour afficher le montant des frais d’origine, le montant du pourboire et le montant total. L’exemple est une application console qui oblige l’utilisateur à fournir la quantité de frais d’origine en tant que paramètre de ligne de commande.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Remarques

La représentation textuelle de value est produite en appelant la méthode Decimal.ToString.

Pour plus d’informations sur la marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Char[])

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit le tableau spécifié de caractères Unicode, suivi du point de terminaison de ligne actuel, dans le flux de sortie standard.

C# 
public static void WriteLine (char[]? buffer);
C# 
public static void WriteLine (char[] buffer);

Paramètres

buffer
Char[]

Tableau de caractères Unicode.

Exceptions

IOException

Une erreur d’E/S s’est produite.

Remarques

Pour plus d’informations sur la marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Char)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit le caractère Unicode spécifié, suivi de l’indicateur de fin de ligne actuel, valeur dans le flux de sortie standard.

C# 
public static void WriteLine (char value);

Paramètres

value
Char

Valeur à écrire.

Exceptions

IOException

Une erreur d’E/S s’est produite.

Exemples

L’exemple suivant est une calculatrice de pourboires qui calcule un pourboire de 18% et utilise la méthode WriteLine pour afficher le montant des frais d’origine, le montant du pourboire et le montant total. L’exemple est une application console qui oblige l’utilisateur à fournir la quantité de frais d’origine en tant que paramètre de ligne de commande.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Remarques

Pour plus d’informations sur la marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Boolean)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit la représentation textuelle de la valeur booléenne spécifiée, suivie de la marque de fin de ligne actuelle, dans le flux de sortie standard.

C# 
public static void WriteLine (bool value);

Paramètres

value
Boolean

Valeur à écrire.

Exceptions

IOException

Une erreur d’E/S s’est produite.

Exemples

L’exemple suivant génère dix entiers aléatoires et utilise la méthode Console.WriteLine(Boolean) pour indiquer s’ils sont même.

C# 
// Assign 10 random integers to an array.
Random rnd = new Random();
int[] numbers = new int[10];
for (int ctr = 0; ctr <= numbers.GetUpperBound(0); ctr++)
   numbers[ctr] = rnd.Next();

// Determine whether the numbers are even or odd.
foreach (var number in numbers) {
   bool even = (number % 2 == 0);
   Console.WriteLine("Is {0} even:", number);
   Console.WriteLine(even);
   Console.WriteLine();
}

Remarques

La représentation textuelle de value est produite en appelant la méthode Boolean.ToString.

Pour plus d’informations sur la marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine()

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit le terminateur de ligne actuel dans le flux de sortie standard.

C# 
public static void WriteLine ();

Exceptions

IOException

Une erreur d’E/S s’est produite.

Exemples

L’exemple montre comment modifier la marque de fin de ligne de sa valeur par défaut «\r\n» ou vbCrLf «\r\n\r\n» ou vbCrLf + vbCrLf. Il appelle ensuite les méthodes WriteLine() et WriteLine(String) pour afficher la sortie dans la console.

C# 
string[] lines = { "This is the first line.",
                   "This is the second line." };
// Output the lines using the default newline sequence.
Console.WriteLine("With the default new line characters:");
Console.WriteLine();
foreach (string line in lines)
   Console.WriteLine(line);

Console.WriteLine();

// Redefine the newline characters to double space.
Console.Out.NewLine = "\r\n\r\n";
// Output the lines using the new newline sequence.
Console.WriteLine("With redefined new line characters:");
Console.WriteLine();
foreach (string line in lines)
   Console.WriteLine(line);

// The example displays the following output:
//       With the default new line characters:
//
//       This is the first line.
//       This is the second line.
//
//       With redefined new line characters:
//
//
//
//       This is the first line.
//
//       This is the second line.

Remarques

Le terminateur de ligne par défaut est une chaîne dont la valeur est un retour chariot suivi d’un flux de ligne («\r\n» en C#, ou vbCrLf en Visual Basic). Vous pouvez modifier la marque de fin de ligne en définissant la propriété TextWriter.NewLine de la propriété Out sur une autre chaîne. L’exemple fournit une illustration.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(String, Object, Object, Object)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit la représentation textuelle des objets spécifiés, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard à l’aide des informations de format spécifiées.

C# 
public static void WriteLine (string format, object? arg0, object? arg1, object? arg2);
C# 
public static void WriteLine (string format, object arg0, object arg1, object arg2);

Paramètres

format
String

Chaîne de format composite.

arg0
Object

Premier objet à écrire à l’aide de format.

arg1
Object

Deuxième objet à écrire à l’aide de format.

arg2
Object

Troisième objet à écrire à l’aide de format.

Exceptions

IOException

Une erreur d’E/S s’est produite.

ArgumentNullException

format est null.

FormatException

La spécification de format dans format n’est pas valide.

Exemples

L’exemple suivant illustre les spécificateurs de mise en forme standard pour les nombres, les dates et les énumérations.

C# 
// This code example demonstrates the Console.WriteLine() method.
// Formatting for this example uses the "en-US" culture.

using System;
class Sample
{
    enum Color {Yellow = 1, Blue, Green};
    static DateTime thisDate = DateTime.Now;

    public static void Main()
    {
        Console.Clear();

        // Format a negative integer or floating-point number in various ways.
        Console.WriteLine("Standard Numeric Format Specifiers");
        Console.WriteLine(
            "(C) Currency: . . . . . . . . {0:C}\n" +
            "(D) Decimal:. . . . . . . . . {0:D}\n" +
            "(E) Scientific: . . . . . . . {1:E}\n" +
            "(F) Fixed point:. . . . . . . {1:F}\n" +
            "(G) General:. . . . . . . . . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(N) Number: . . . . . . . . . {0:N}\n" +
            "(P) Percent:. . . . . . . . . {1:P}\n" +
            "(R) Round-trip: . . . . . . . {1:R}\n" +
            "(X) Hexadecimal:. . . . . . . {0:X}\n",
            -123, -123.45f);

        // Format the current date in various ways.
        Console.WriteLine("Standard DateTime Format Specifiers");
        Console.WriteLine(
            "(d) Short date: . . . . . . . {0:d}\n" +
            "(D) Long date:. . . . . . . . {0:D}\n" +
            "(t) Short time: . . . . . . . {0:t}\n" +
            "(T) Long time:. . . . . . . . {0:T}\n" +
            "(f) Full date/short time: . . {0:f}\n" +
            "(F) Full date/long time:. . . {0:F}\n" +
            "(g) General date/short time:. {0:g}\n" +
            "(G) General date/long time: . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(M) Month:. . . . . . . . . . {0:M}\n" +
            "(R) RFC1123:. . . . . . . . . {0:R}\n" +
            "(s) Sortable: . . . . . . . . {0:s}\n" +
            "(u) Universal sortable: . . . {0:u} (invariant)\n" +
            "(U) Universal full date/time: {0:U}\n" +
            "(Y) Year: . . . . . . . . . . {0:Y}\n",
            thisDate);

        // Format a Color enumeration value in various ways.
        Console.WriteLine("Standard Enumeration Format Specifiers");
        Console.WriteLine(
            "(G) General:. . . . . . . . . {0:G}\n" +
            "    (default):. . . . . . . . {0} (default = 'G')\n" +
            "(F) Flags:. . . . . . . . . . {0:F} (flags or integer)\n" +
            "(D) Decimal number: . . . . . {0:D}\n" +
            "(X) Hexadecimal:. . . . . . . {0:X}\n",
            Color.Green);
    }
}
/*
This code example produces the following results:

Standard Numeric Format Specifiers
(C) Currency: . . . . . . . . ($123.00)
(D) Decimal:. . . . . . . . . -123
(E) Scientific: . . . . . . . -1.234500E+002
(F) Fixed point:. . . . . . . -123.45
(G) General:. . . . . . . . . -123
    (default):. . . . . . . . -123 (default = 'G')
(N) Number: . . . . . . . . . -123.00
(P) Percent:. . . . . . . . . -12,345.00 %
(R) Round-trip: . . . . . . . -123.45
(X) Hexadecimal:. . . . . . . FFFFFF85

Standard DateTime Format Specifiers
(d) Short date: . . . . . . . 6/26/2004
(D) Long date:. . . . . . . . Saturday, June 26, 2004
(t) Short time: . . . . . . . 8:11 PM
(T) Long time:. . . . . . . . 8:11:04 PM
(f) Full date/short time: . . Saturday, June 26, 2004 8:11 PM
(F) Full date/long time:. . . Saturday, June 26, 2004 8:11:04 PM
(g) General date/short time:. 6/26/2004 8:11 PM
(G) General date/long time: . 6/26/2004 8:11:04 PM
    (default):. . . . . . . . 6/26/2004 8:11:04 PM (default = 'G')
(M) Month:. . . . . . . . . . June 26
(R) RFC1123:. . . . . . . . . Sat, 26 Jun 2004 20:11:04 GMT
(s) Sortable: . . . . . . . . 2004-06-26T20:11:04
(u) Universal sortable: . . . 2004-06-26 20:11:04Z (invariant)
(U) Universal full date/time: Sunday, June 27, 2004 3:11:04 AM
(Y) Year: . . . . . . . . . . June, 2004

Standard Enumeration Format Specifiers
(G) General:. . . . . . . . . Green
    (default):. . . . . . . . Green (default = 'G')
(F) Flags:. . . . . . . . . . Green (flags or integer)
(D) Decimal number: . . . . . 3
(X) Hexadecimal:. . . . . . . 00000003

*/

L’exemple suivant est une calculatrice de pourboires qui calcule un pourboire de 18% et utilise la méthode WriteLine pour afficher le montant des frais d’origine, le montant du pourboire et le montant total. L’exemple est une application console qui oblige l’utilisateur à fournir la quantité de frais d’origine en tant que paramètre de ligne de commande.

C# 
using System;

public class TipCalculator
{
    private const double tipRate = 0.18;
    public static void Main(string[] args)
    {
        double billTotal;
        if (args.Length == 0 || ! Double.TryParse(args[0], out billTotal))
        {
            Console.WriteLine("usage: TIPCALC total");
            return;
        }
        double tip = billTotal * tipRate;
        Console.WriteLine();
        Console.WriteLine($"Bill total:\t{billTotal,8:c}");
        Console.WriteLine($"Tip total/rate:\t{tip,8:c} ({tipRate:p1})");
        Console.WriteLine(("").PadRight(24, '-'));
        Console.WriteLine($"Grand total:\t{billTotal + tip,8:c}");
    }
}

/*
>tipcalc 52.23

Bill total:       $52.23
Tip total/rate:    $9.40 (18.0 %)
------------------------
Grand total:      $61.63
*/

Remarques

Cette méthode utilise la fonctionnalité de mise en forme composite de .NET pour convertir la valeur d’un objet en sa représentation textuelle et incorporer cette représentation dans une chaîne. La chaîne résultante est écrite dans le flux de sortie.

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 textuelle de la valeur de l’objet correspondant.

La syntaxe d’un élément de format est {index[,alignement][:formatString]}, qui spécifie un index obligatoire, la longueur facultative et l’alignement du texte mis en forme et une chaîne facultative de caractères spécificateurs de format qui régissent la façon dont la valeur de l’objet correspondant est mise en forme.

.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 marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(Object)

Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

Écrit la représentation textuelle de l’objet spécifié, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard.

C# 
public static void WriteLine (object? value);
C# 
public static void WriteLine (object value);

Paramètres

value
Object

Valeur à écrire.

Exceptions

IOException

Une erreur d’E/S s’est produite.

Exemples

L’exemple suivant utilise la méthode WriteLine(Object) pour afficher chaque valeur d’un tableau d’objets dans la console.

C# 
Object[] values = { true, 12.632, 17908, "stringValue",
                           'a', 16907.32m };
foreach (var value in values)
   Console.WriteLine(value);

// The example displays the following output:
//    True
//    12.632
//    17908
//    stringValue
//    a
//    16907.32

Remarques

Si value est null, seul le terminateur de ligne est écrit. Sinon, la méthode ToString de value est appelée pour produire sa représentation sous forme de chaîne et la chaîne résultante est écrite dans le flux de sortie standard.

Pour plus d’informations sur la marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

WriteLine(String, Object, Object, Object, Object)

Important

Cette API n’est pas conforme CLS.

Écrit la représentation textuelle des objets spécifiés et de la liste des paramètres de longueur variable, suivie du point de terminaison de ligne actuel, dans le flux de sortie standard à l’aide des informations de format spécifiées.

C# 
[System.CLSCompliant(false)]
public static void WriteLine (string format, object arg0, object arg1, object arg2, object arg3);

Paramètres

format
String

Chaîne de format composite.

arg0
Object

Premier objet à écrire à l’aide de format.

arg1
Object

Deuxième objet à écrire à l’aide de format.

arg2
Object

Troisième objet à écrire à l’aide de format.

arg3
Object

Quatrième objet à écrire à l’aide de format.

Attributs
CLSCompliantAttribute

Exceptions

IOException

Une erreur d’E/S s’est produite.

ArgumentNullException

format est null.

FormatException

La spécification de format dans format n’est pas valide.

Exemples

L’exemple suivant illustre l’utilisation d’arguments de variable avec la méthode WriteLine(String, Object, Object, Object, Object). La méthode est appelée avec une chaîne de format composite et cinq éléments de format.

C++ 
using namespace System;

int CountLetters(String^ value);
int CountWhitespace(String^ value);

void main()
{
   String^ value = "This is a test string.";
   
   
   Console::WriteLine("The string '{0}' consists of:" +
                      "{4}{1} characters{4}{2} letters{4}" +
                      "{3} white-space characters", 
                      value, value->Length, CountLetters(value), 
                      CountWhitespace(value), Environment::NewLine);
}

int CountLetters(String^ value)
{
   int nLetters = 0;
   for each (Char ch in value) {
      if (Char::IsLetter(ch))
         nLetters++;
   }
   return nLetters;
}

int CountWhitespace(String^ value)
{
   int nWhitespace = 0;
   for each (Char ch in value) {
      if (Char::IsWhiteSpace(ch))
         nWhitespace++;
   }
   return nWhitespace;
}
// The example displays the following output:
//    The string 'This is a test string.' consists of:
//    22 characters
//    17 letters
//    4 white-space characters

Remarques

Note

Cette API n’est pas conforme CLS. L’alternative conforme CLS est Console.WriteLine(String, Object[]). Les compilateurs C# et Visual Basic résolvent automatiquement un appel à cette méthode en tant qu’appel à Console.WriteLine(String, Object[]).

Cette méthode utilise la fonctionnalité de mise en forme composite de .NET pour convertir la valeur d’un objet en sa représentation textuelle et incorporer cette représentation dans une chaîne. La chaîne résultante est écrite dans le flux de sortie.

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 textuelle de la valeur de l’objet correspondant.

La syntaxe d’un élément de format est {index[,alignement][:formatString]}, qui spécifie un index obligatoire, la longueur facultative et l’alignement du texte mis en forme et une chaîne facultative de caractères spécificateurs de format qui régissent la façon dont la valeur de l’objet correspondant est mise en forme.

.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 marque de fin de ligne, consultez la section Notes de la méthode WriteLine qui ne prend aucun paramètre.

Notes pour les appelants

Cette méthode est marquée avec le mot clé vararg, ce qui signifie qu’elle prend en charge un nombre variable de paramètres. La méthode peut être appelée à partir de Visual C++, mais elle ne peut pas être appelée à partir de C# ou de code Visual Basic. Les compilateurs C# et Visual Basic résolvent les appels à WriteLine(String, Object, Object, Object, Object) en tant qu’appels à WriteLine(String, Object[]).

Voir aussi

S’applique à

.NET Framework 4.8.1 et autres versions
Produit Versions
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1