Console.WriteLine Metoda

Definice

Zapíše zadaná data následovaná ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

Přetížení

WriteLine(String, Object, Object)

Zapíše textovou reprezentaci zadaných objektů následovaných ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu pomocí zadaných informací o formátu.

WriteLine(String)

Zapíše zadanou řetězcovou hodnotu následovanou ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

WriteLine(Char[], Int32, Int32)

Zapíše zadanou podřetěru znaků Unicode následovanou ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

WriteLine(String, ReadOnlySpan<Object>)

Zapíše textovou reprezentaci zadaného rozsahu objektů následovaných ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu pomocí zadaných informací o formátu.

WriteLine(String, Object[])

Zapíše textovou reprezentaci zadaného pole objektů následovaných ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu pomocí zadaných informací o formátu.

WriteLine(String, Object)

Zapíše textovou reprezentaci zadaného objektu následovaného ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu pomocí zadaných informací o formátu.

WriteLine(UInt64)

Zapíše textovou reprezentaci zadané 64bitové celočíselné hodnoty bez znaménka následované aktuálním ukončovacím znakem řádku do standardního výstupního datového proudu.

WriteLine(UInt32)

Zapíše textovou reprezentaci zadané 32bitové celočíselné hodnoty bez znaménka následované aktuálním ukončovacím znakem řádku do standardního výstupního datového proudu.

WriteLine(Single)

Zapíše textovou reprezentaci zadané hodnoty s plovoucí desetinnou čárkou s jednoduchou přesností následovanou ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

WriteLine(Double)

Zapíše textovou reprezentaci zadané hodnoty s plovoucí desetinnou čárkou s dvojitou přesností následovanou ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

WriteLine(Int64)

Zapíše textovou reprezentaci zadané 64bitové celočíselné hodnoty, za kterou následuje ukončovací znak aktuálního řádku, do standardního výstupního datového proudu.

WriteLine(Int32)

Zapíše textovou reprezentaci zadané 32bitové celočíselné hodnoty se tržinou adresou následovanou ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

WriteLine(Decimal)

Zapíše textovou reprezentaci zadané Decimal hodnoty následované ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

WriteLine(Char[])

Zapíše zadanou matici znaků Unicode následovanou ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

WriteLine(Char)

Zapíše zadaný znak Unicode následovaný ukončovacím znakem aktuálního řádku a hodnotu do standardního výstupního datového proudu.

WriteLine(Boolean)

Zapíše textovou reprezentaci zadané logické hodnoty následované ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

WriteLine()

Zapíše ukončovací znak aktuálního řádku do standardního výstupního datového proudu.

WriteLine(String, Object, Object, Object)

Zapíše textovou reprezentaci zadaných objektů následovaných ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu pomocí zadaných informací o formátu.

WriteLine(Object)

Zapíše textovou reprezentaci zadaného objektu následovaného ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

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

Zapíše textovou reprezentaci zadaných objektů a seznamu parametrů s proměnnou délkou následovaný ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu pomocí zadaných informací o formátu.

Poznámky

Výchozí ukončovací znak řádku je řetězec, jehož hodnota je návrat na začátek řádku následovaný informačním kanálem řádku ("\r\n" v jazyce C# nebo vbCrLf v jazyce Visual Basic). Ukončovací znak řádku můžete změnit nastavením vlastnosti TextWriter.NewLine vlastnosti Out na jiný řetězec.

WriteLine(String, Object, Object)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše textovou reprezentaci zadaných objektů následovaných ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu pomocí zadaných informací o formátu.

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

Parametry

format
String

Složený formátovací řetězec.

arg0
Object

První objekt k zápisu pomocí format.

arg1
Object

Druhý objekt k zápisu pomocí format.

Výjimky

Došlo k vstupně-výstupní chybě.

format je null.

Specifikace formátu v format je neplatná.

Příklady

Následující příklad ukazuje standardní specifikátory formátování pro čísla, kalendářní data a výčty.

// 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

*/

Následující příklad je kalkulačka tipu, která vypočítá 18% tip a používá metodu WriteLine k zobrazení částky původního poplatku, částky tipu a celkové částky. Příkladem je konzolová aplikace, která vyžaduje, aby uživatel jako parametr příkazového řádku dodal částku původního poplatku.

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
*/

Poznámky

Tato metoda používá funkci složeného formátování rozhraní .NET k převodu hodnoty objektu na jeho textové vyjádření a vložení této reprezentace do řetězce. Výsledný řetězec se zapíše do výstupního datového proudu.

Parametr format se skládá z nuly nebo více spuštění textu intermixovaného s nulovým nebo více indexovanými zástupnými symboly, označovanými jako položky formátu, které odpovídají objektu v seznamu parametrů této metody. Proces formátování nahradí každou položku formátu textovou reprezentací hodnoty odpovídajícího objektu.

Syntaxe položky formátu je {index[,zarovnání][:formatString]}, který určuje povinný index, volitelnou délku a zarovnání formátovaného textu a volitelný řetězec znaků specifikátoru formátu, které určují, jak je hodnota odpovídajícího objektu formátována.

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše zadanou řetězcovou hodnotu následovanou ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

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

Parametry

value
String

Hodnota k zápisu.

Výjimky

Došlo k vstupně-výstupní chybě.

Příklady

Příklad změní ukončovací znak řádku z výchozí hodnoty "\r\n" nebo vbCrLf na "\r\n\r\n" nebo vbCrLf + vbCrLf. Potom zavolá WriteLine() a WriteLine(String) metody pro zobrazení výstupu do konzoly.

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.

Poznámky

Pokud je hodnota null, zapíše se do standardního výstupního datového proudu pouze ukončovací čára.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine() metoda.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše zadanou podřetěru znaků Unicode následovanou ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

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

Parametry

buffer
Char[]

Pole znaků Unicode.

index
Int32

Počáteční pozice v buffer.

count
Int32

Počet znaků, které se mají napsat.

Výjimky

buffer je null.

index nebo count je menší než nula.

index plus count určit pozici, která není v buffer.

Došlo k vstupně-výstupní chybě.

Poznámky

Tato metoda zapisuje count znaky začínající na pozici indexbuffer do standardního výstupního datového proudu.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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>)

Zapíše textovou reprezentaci zadaného rozsahu objektů následovaných ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu pomocí zadaných informací o formátu.

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

Parametry

format
String

Složený formátovací řetězec.

arg
ReadOnlySpan<Object>

Rozsah objektů k zápisu pomocí formátu.

Platí pro

.NET 9
Produkt Verze
.NET 9

WriteLine(String, Object[])

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše textovou reprezentaci zadaného pole objektů následovaných ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu pomocí zadaných informací o formátu.

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

Parametry

format
String

Složený formátovací řetězec.

arg
Object[]

Pole objektů k zápisu pomocí format.

Výjimky

Došlo k vstupně-výstupní chybě.

format nebo arg je null.

Specifikace formátu v format je neplatná.

Příklady

Následující příklad ukazuje standardní specifikátory formátování pro čísla, kalendářní data a výčty.

// 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

*/

Následující příklad je kalkulačka tipu, která vypočítá 18% tip a používá metodu WriteLine k zobrazení částky původního poplatku, částky tipu a celkové částky. Příkladem je konzolová aplikace, která vyžaduje, aby uživatel jako parametr příkazového řádku dodal částku původního poplatku.

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
*/

Poznámky

Tato metoda používá funkci složeného formátování rozhraní .NET k převodu hodnoty objektu na jeho textové vyjádření a vložení této reprezentace do řetězce. Výsledný řetězec se zapíše do výstupního datového proudu.

Parametr format se skládá z nuly nebo více spuštění textu intermixovaného s nulovým nebo více indexovanými zástupnými symboly, označovanými jako položky formátu, které odpovídají objektu v seznamu parametrů této metody. Proces formátování nahradí každou položku formátu textovou reprezentací hodnoty odpovídajícího objektu.

Syntaxe položky formátu je {index[,zarovnání][:formatString]}, který určuje povinný index, volitelnou délku a zarovnání formátovaného textu a volitelný řetězec znaků specifikátoru formátu, které určují, jak je hodnota odpovídajícího objektu formátována.

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Poznámky pro volající

Tato metoda není volána kódem jazyka C++. Kompilátor C++ překládá volání System.Console.WriteLine, které obsahují řetězec a seznam čtyř nebo více parametrů objektu jako volání WriteLine(String, Object, Object, Object, Object). Řeší volání System.Console.WriteLine, které obsahují řetězec a pole objektů jako volání WriteLine(String, Object).

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše textovou reprezentaci zadaného objektu následovaného ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu pomocí zadaných informací o formátu.

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

Parametry

format
String

Složený formátovací řetězec.

arg0
Object

Objekt k zápisu pomocí format.

Výjimky

Došlo k vstupně-výstupní chybě.

format je null.

Specifikace formátu v format je neplatná.

Příklady

Následující příklad volá metodu WriteLine(String, Object) k zobrazení pěti náhodně generovaných Boolean hodnot.

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

Následující příklad volá metodu WriteLine(String, Object) k zobrazení aktuálního data. Všimněte si, že položka formátu v argumentu format používá řetězec formátu "D" standardní formát data a času k zobrazení data v dlouhém formátu data aktuální jazykové verze.

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

Poznámky

Tato metoda používá funkci složeného formátování rozhraní .NET k převodu hodnoty objektu na jeho textové vyjádření a vložení této reprezentace do řetězce. Výsledný řetězec se zapíše do výstupního datového proudu.

Parametr format se skládá z nuly nebo více spuštění textu intermixovaného s nulovým nebo více indexovanými zástupnými symboly, označovanými jako položky formátu, které odpovídají objektu v seznamu parametrů této metody. Proces formátování nahradí každou položku formátu textovou reprezentací hodnoty odpovídajícího objektu.

Syntaxe položky formátu je {index[,zarovnání][:formatString]}, který určuje povinný index, volitelnou délku a zarovnání formátovaného textu a volitelný řetězec znaků specifikátoru formátu, které určují, jak je hodnota odpovídajícího objektu formátována.

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Zapíše textovou reprezentaci zadané 64bitové celočíselné hodnoty bez znaménka následované aktuálním ukončovacím znakem řádku do standardního výstupního datového proudu.

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

Parametry

value
UInt64

Hodnota k zápisu.

Atributy

Výjimky

Došlo k vstupně-výstupní chybě.

Příklady

Následující příklad je kalkulačka tipu, která vypočítá 18% tip a používá metodu WriteLine k zobrazení částky původního poplatku, částky tipu a celkové částky. Příkladem je konzolová aplikace, která vyžaduje, aby uživatel jako parametr příkazového řádku dodal částku původního poplatku.

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
*/

Poznámky

Textová reprezentace value je vytvořena voláním UInt64.ToString metody.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Zapíše textovou reprezentaci zadané 32bitové celočíselné hodnoty bez znaménka následované aktuálním ukončovacím znakem řádku do standardního výstupního datového proudu.

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

Parametry

value
UInt32

Hodnota k zápisu.

Atributy

Výjimky

Došlo k vstupně-výstupní chybě.

Příklady

Následující příklad je kalkulačka tipu, která vypočítá 18% tip a používá metodu WriteLine k zobrazení částky původního poplatku, částky tipu a celkové částky. Příkladem je konzolová aplikace, která vyžaduje, aby uživatel jako parametr příkazového řádku dodal částku původního poplatku.

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
*/

Poznámky

Textová reprezentace value je vytvořena voláním UInt32.ToString metody.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše textovou reprezentaci zadané hodnoty s plovoucí desetinnou čárkou s jednoduchou přesností následovanou ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

public static void WriteLine (float value);

Parametry

value
Single

Hodnota k zápisu.

Výjimky

Došlo k vstupně-výstupní chybě.

Příklady

Následující příklad je kalkulačka tipu, která vypočítá 18% tip a používá metodu WriteLine k zobrazení částky původního poplatku, částky tipu a celkové částky. Příkladem je konzolová aplikace, která vyžaduje, aby uživatel jako parametr příkazového řádku dodal částku původního poplatku.

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
*/

Poznámky

Textová reprezentace value je vytvořena voláním Single.ToString metody.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše textovou reprezentaci zadané hodnoty s plovoucí desetinnou čárkou s dvojitou přesností následovanou ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

public static void WriteLine (double value);

Parametry

value
Double

Hodnota k zápisu.

Výjimky

Došlo k vstupně-výstupní chybě.

Příklady

Následující příklad je kalkulačka tipu, která vypočítá 18% tip a používá metodu WriteLine k zobrazení částky původního poplatku, částky tipu a celkové částky. Příkladem je konzolová aplikace, která vyžaduje, aby uživatel jako parametr příkazového řádku dodal částku původního poplatku.

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
*/

Poznámky

Textová reprezentace value je vytvořena voláním Double.ToString metody.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše textovou reprezentaci zadané 64bitové celočíselné hodnoty, za kterou následuje ukončovací znak aktuálního řádku, do standardního výstupního datového proudu.

public static void WriteLine (long value);

Parametry

value
Int64

Hodnota k zápisu.

Výjimky

Došlo k vstupně-výstupní chybě.

Příklady

Následující příklad je kalkulačka tipu, která vypočítá 18% tip a používá metodu WriteLine k zobrazení částky původního poplatku, částky tipu a celkové částky. Příkladem je konzolová aplikace, která vyžaduje, aby uživatel jako parametr příkazového řádku dodal částku původního poplatku.

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
*/

Poznámky

Textová reprezentace value je vytvořena voláním Int64.ToString metody.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše textovou reprezentaci zadané 32bitové celočíselné hodnoty se tržinou adresou následovanou ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

public static void WriteLine (int value);

Parametry

value
Int32

Hodnota k zápisu.

Výjimky

Došlo k vstupně-výstupní chybě.

Příklady

Následující příklad je kalkulačka tipu, která vypočítá 18% tip a používá metodu WriteLine k zobrazení částky původního poplatku, částky tipu a celkové částky. Příkladem je konzolová aplikace, která vyžaduje, aby uživatel jako parametr příkazového řádku dodal částku původního poplatku.

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
*/

Poznámky

Textová reprezentace value je vytvořena voláním Int32.ToString metody.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše textovou reprezentaci zadané Decimal hodnoty následované ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

public static void WriteLine (decimal value);

Parametry

value
Decimal

Hodnota k zápisu.

Výjimky

Došlo k vstupně-výstupní chybě.

Příklady

Následující příklad je kalkulačka tipu, která vypočítá 18% tip a používá metodu WriteLine k zobrazení částky původního poplatku, částky tipu a celkové částky. Příkladem je konzolová aplikace, která vyžaduje, aby uživatel jako parametr příkazového řádku dodal částku původního poplatku.

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
*/

Poznámky

Textová reprezentace value je vytvořena voláním Decimal.ToString metody.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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[])

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše zadanou matici znaků Unicode následovanou ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

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

Parametry

buffer
Char[]

Pole znaků Unicode.

Výjimky

Došlo k vstupně-výstupní chybě.

Poznámky

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše zadaný znak Unicode následovaný ukončovacím znakem aktuálního řádku a hodnotu do standardního výstupního datového proudu.

public static void WriteLine (char value);

Parametry

value
Char

Hodnota k zápisu.

Výjimky

Došlo k vstupně-výstupní chybě.

Příklady

Následující příklad je kalkulačka tipu, která vypočítá 18% tip a používá metodu WriteLine k zobrazení částky původního poplatku, částky tipu a celkové částky. Příkladem je konzolová aplikace, která vyžaduje, aby uživatel jako parametr příkazového řádku dodal částku původního poplatku.

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
*/

Poznámky

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše textovou reprezentaci zadané logické hodnoty následované ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

public static void WriteLine (bool value);

Parametry

value
Boolean

Hodnota k zápisu.

Výjimky

Došlo k vstupně-výstupní chybě.

Příklady

Následující příklad generuje deset náhodných celých čísel a používá metodu Console.WriteLine(Boolean) k označení, zda jsou sudé.

// 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();
}

Poznámky

Textová reprezentace value je vytvořena voláním Boolean.ToString metody.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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()

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše ukončovací znak aktuálního řádku do standardního výstupního datového proudu.

public static void WriteLine ();

Výjimky

Došlo k vstupně-výstupní chybě.

Příklady

Příklad změní ukončovací znak řádku z výchozí hodnoty "\r\n" nebo vbCrLf na "\r\n\r\n" nebo vbCrLf + vbCrLf. Potom zavolá WriteLine() a WriteLine(String) metody pro zobrazení výstupu do konzoly.

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.

Poznámky

Výchozí ukončovací znak řádku je řetězec, jehož hodnota je návrat na začátek řádku následovaný informačním kanálem řádku ("\r\n" v jazyce C# nebo vbCrLf v jazyce Visual Basic). Ukončovací znak řádku můžete změnit nastavením vlastnosti TextWriter.NewLine vlastnosti Out na jiný řetězec. Příklad obsahuje obrázek.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše textovou reprezentaci zadaných objektů následovaných ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu pomocí zadaných informací o formátu.

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

Parametry

format
String

Složený formátovací řetězec.

arg0
Object

První objekt k zápisu pomocí format.

arg1
Object

Druhý objekt k zápisu pomocí format.

arg2
Object

Třetí objekt k zápisu pomocí format.

Výjimky

Došlo k vstupně-výstupní chybě.

format je null.

Specifikace formátu v format je neplatná.

Příklady

Následující příklad ukazuje standardní specifikátory formátování pro čísla, kalendářní data a výčty.

// 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

*/

Následující příklad je kalkulačka tipu, která vypočítá 18% tip a používá metodu WriteLine k zobrazení částky původního poplatku, částky tipu a celkové částky. Příkladem je konzolová aplikace, která vyžaduje, aby uživatel jako parametr příkazového řádku dodal částku původního poplatku.

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
*/

Poznámky

Tato metoda používá funkci složeného formátování rozhraní .NET k převodu hodnoty objektu na jeho textové vyjádření a vložení této reprezentace do řetězce. Výsledný řetězec se zapíše do výstupního datového proudu.

Parametr format se skládá z nuly nebo více spuštění textu intermixovaného s nulovým nebo více indexovanými zástupnými symboly, označovanými jako položky formátu, které odpovídají objektu v seznamu parametrů této metody. Proces formátování nahradí každou položku formátu textovou reprezentací hodnoty odpovídajícího objektu.

Syntaxe položky formátu je {index[,zarovnání][:formatString]}, který určuje povinný index, volitelnou délku a zarovnání formátovaného textu a volitelný řetězec znaků specifikátoru formátu, které určují, jak je hodnota odpovídajícího objektu formátována.

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Zdroj:
Console.cs
Zdroj:
Console.cs
Zdroj:
Console.cs

Zapíše textovou reprezentaci zadaného objektu následovaného ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu.

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

Parametry

value
Object

Hodnota k zápisu.

Výjimky

Došlo k vstupně-výstupní chybě.

Příklady

Následující příklad používá metodu WriteLine(Object) k zobrazení každé hodnoty v poli objektů v konzole.

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

Poznámky

Pokud je valuenull, zapíše se pouze ukončovací znak řádku. V opačném případě je volána ToString metoda value k vytvoření řetězcové reprezentace a výsledný řetězec se zapíše do standardního výstupního datového proudu.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.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)

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Zapíše textovou reprezentaci zadaných objektů a seznamu parametrů s proměnnou délkou následovaný ukončovacím znakem aktuálního řádku do standardního výstupního datového proudu pomocí zadaných informací o formátu.

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

Parametry

format
String

Složený formátovací řetězec.

arg0
Object

První objekt k zápisu pomocí format.

arg1
Object

Druhý objekt k zápisu pomocí format.

arg2
Object

Třetí objekt k zápisu pomocí format.

arg3
Object

Čtvrtý objekt k zápisu pomocí format.

Atributy

Výjimky

Došlo k vstupně-výstupní chybě.

format je null.

Specifikace formátu v format je neplatná.

Příklady

Následující příklad ukazuje použití argumentů proměnné s WriteLine(String, Object, Object, Object, Object) metoda. Metoda je volána s složeným formátovacím řetězcem a pěti položkami formátu.

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

Poznámky

Poznámka

Toto rozhraní API nedodržuje předpisy CLS. Alternativou kompatibilní se specifikací CLS je Console.WriteLine(String, Object[]). Kompilátory jazyka C# a Visual Basic automaticky přeloží volání této metody jako volání Console.WriteLine(String, Object[]).

Tato metoda používá funkci složeného formátování rozhraní .NET k převodu hodnoty objektu na jeho textové vyjádření a vložení této reprezentace do řetězce. Výsledný řetězec se zapíše do výstupního datového proudu.

Parametr format se skládá z nuly nebo více spuštění textu intermixovaného s nulovým nebo více indexovanými zástupnými symboly, označovanými jako položky formátu, které odpovídají objektu v seznamu parametrů této metody. Proces formátování nahradí každou položku formátu textovou reprezentací hodnoty odpovídajícího objektu.

Syntaxe položky formátu je {index[,zarovnání][:formatString]}, který určuje povinný index, volitelnou délku a zarovnání formátovaného textu a volitelný řetězec znaků specifikátoru formátu, které určují, jak je hodnota odpovídajícího objektu formátována.

.NET poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech o formátování.

Další informace o ukončovací čáry naleznete v části Poznámky WriteLine metoda, která nepřijímá žádné parametry.

Poznámky pro volající

Tato metoda je označena klíčovým slovem vararg, což znamená, že podporuje proměnný počet parametrů. Metodu lze volat z jazyka Visual C++, ale nelze ji volat z kódu jazyka C# nebo Visual Basic. Kompilátory jazyka C# a Visual Basic přeloží volání WriteLine(String, Object, Object, Object, Object) jako volání WriteLine(String, Object[]).

Viz také

Platí pro

.NET Framework 4.8.1 a další verze
Produkt Verze
.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