Przeczytaj w języku angielskim

Udostępnij za pośrednictwem

Console.WriteLine Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System
Zestaw:
System.Console.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll

Zapisuje określone dane, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.

Przeciążenia

WriteLine(String, Object, Object)

Zapisuje reprezentację tekstową określonych obiektów, a następnie bieżący terminator wiersza, do standardowego strumienia wyjściowego przy użyciu określonych informacji o formacie.
WriteLine(String)

Zapisuje określoną wartość ciągu, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.
WriteLine(Char[], Int32, Int32)

Zapisuje określoną podarraję znaków Unicode, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.
WriteLine(String, ReadOnlySpan<Object>)

Zapisuje reprezentację tekstową określonego zakresu obiektów, po którym następuje bieżący terminator wiersza, do standardowego strumienia wyjściowego przy użyciu określonych informacji o formacie.
WriteLine(String, Object[])

Zapisuje reprezentację tekstową określonej tablicy obiektów, po której następuje bieżący terminator wiersza, do standardowego strumienia wyjściowego przy użyciu określonych informacji o formacie.
WriteLine(String, Object)

Zapisuje reprezentację tekstową określonego obiektu, po którym następuje bieżący terminator wiersza, do standardowego strumienia wyjściowego przy użyciu określonych informacji o formacie.
WriteLine(UInt64)

Zapisuje reprezentację tekstową określonej 64-bitowej niepodpisanej wartości całkowitej, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.
WriteLine(UInt32)

Zapisuje tekstową reprezentację określonej 32-bitowej niepodpisanej wartości całkowitej, po której następuje bieżący terminator wiersza, do standardowego strumienia wyjściowego.
WriteLine(Single)

Zapisuje reprezentację tekstową określonej wartości zmiennoprzecinkowej o pojedynczej precyzji, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.
WriteLine(Double)

Zapisuje reprezentację tekstową określonej wartości zmiennoprzecinkowej o podwójnej precyzji, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.
WriteLine(Int64)

Zapisuje tekstową reprezentację określonej 64-bitowej liczby całkowitej ze znakiem, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.
WriteLine(Int32)

Zapisuje tekstową reprezentację określonej 32-bitowej liczby całkowitej ze znakiem, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.
WriteLine(Decimal)

Zapisuje tekstową reprezentację określonej wartości Decimal, po której następuje bieżący terminator wiersza, do standardowego strumienia wyjściowego.
WriteLine(Char[])

Zapisuje określoną tablicę znaków Unicode, po której następuje bieżący terminator wiersza, do standardowego strumienia wyjściowego.
WriteLine(Char)

Zapisuje określony znak Unicode, po którym następuje bieżący terminator wiersza, wartość standardowego strumienia wyjściowego.
WriteLine(Boolean)

Zapisuje tekstową reprezentację określonej wartości logicznej, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.
WriteLine()

Zapisuje bieżący terminator wiersza w standardowym strumieniu wyjściowym.
WriteLine(String, Object, Object, Object)

Zapisuje reprezentację tekstową określonych obiektów, a następnie bieżący terminator wiersza, do standardowego strumienia wyjściowego przy użyciu określonych informacji o formacie.
WriteLine(Object)

Zapisuje reprezentację tekstową określonego obiektu, po którym następuje bieżący terminator wiersza, do standardowego strumienia wyjściowego.
WriteLine(String, Object, Object, Object, Object)

Zapisuje tekstową reprezentację określonych obiektów i listy parametrów o zmiennej długości, a następnie bieżący terminator wiersza, do standardowego strumienia wyjściowego przy użyciu określonych informacji o formacie.

Uwagi

Domyślny terminator wiersza to ciąg, którego wartość jest zwracanym karetkiem, po którym następuje źródło wiersza ("\r\n" w języku C#, lub vbCrLf w Visual Basic). Terminator wiersza można zmienić, ustawiając właściwość TextWriter.NewLine właściwości Out na inny ciąg.

WriteLine(String, Object, Object)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje reprezentację tekstową określonych obiektów, a następnie bieżący terminator wiersza, do standardowego strumienia wyjściowego przy użyciu określonych informacji o formacie.

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

Parametry

format
String

Ciąg formatu złożonego.

arg0
Object

Pierwszy obiekt do zapisu przy użyciu format.

arg1
Object

Drugi obiekt do zapisu przy użyciu format.

Wyjątki

IOException

Wystąpił błąd we/wy.

ArgumentNullException

format jest null.

FormatException

Specyfikacja formatu w format jest nieprawidłowa.

Przykłady

W poniższym przykładzie przedstawiono standardowe specyfikatory formatowania liczb, dat i wyliczenia.

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

*/

Poniższy przykład to kalkulator wskazówek, który oblicza 18% poradę i używa metody WriteLine, aby wyświetlić kwotę oryginalnego opłaty, kwotę końcówki i łączną kwotę. Przykładem jest aplikacja konsolowa, która wymaga od użytkownika podania kwoty oryginalnej opłaty jako parametru wiersza polecenia.

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

Uwagi

Ta metoda używa funkcji formatowania złożonego platformy .NET, aby przekonwertować wartość obiektu na jego reprezentację tekstową i osadzić tę reprezentację w ciągu. Wynikowy ciąg jest zapisywany w strumieniu wyjściowym.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektowi na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu tekstem reprezentującym wartość odpowiedniego obiektu.

Składnią elementu formatu jest {indeks[,wyrównania][:formatString]}, który określa obowiązkowy indeks, opcjonalną długość i wyrównanie sformatowanego tekstu oraz opcjonalny ciąg znaków specyfikatora formatu, które określają sposób formatowania wartości odpowiedniego obiektu.

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w poniższych tematach formatowania.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje określoną wartość ciągu, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.

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

Parametry

value
String

Wartość do zapisania.

Wyjątki

IOException

Wystąpił błąd we/wy.

Przykłady

Przykład zmienia terminator wiersza z domyślnej wartości "\r\n" lub vbCrLf na "\r\n\r\n" lub vbCrLf + vbCrLf. Następnie wywołuje metody WriteLine() i WriteLine(String), aby wyświetlić dane wyjściowe w konsoli.

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.

Uwagi

Jeśli wartość jest null, do standardowego strumienia wyjściowego jest zapisywany tylko terminator wierszy.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine().

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje określoną podarraję znaków Unicode, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.

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

Parametry

buffer
Char[]

Tablica znaków Unicode.

index
Int32

Pozycja początkowa w buffer.

count
Int32

Liczba znaków do zapisania.

Wyjątki

ArgumentNullException

buffer jest null.

ArgumentOutOfRangeException

index lub count jest mniejsza niż zero.

ArgumentException

index plus count określ pozycję, która nie znajduje się w buffer.

IOException

Wystąpił błąd we/wy.

Uwagi

Ta metoda zapisuje count znaków rozpoczynających się od pozycji indexbuffer do standardowego strumienia wyjściowego.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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>)

Zapisuje reprezentację tekstową określonego zakresu obiektów, po którym następuje bieżący terminator wiersza, do standardowego strumienia wyjściowego przy użyciu określonych informacji o formacie.

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

Parametry

format
String

Ciąg formatu złożonego.

arg
ReadOnlySpan<Object>

Zakres obiektów do zapisu przy użyciu formatu.

Dotyczy

.NET 9
Produkt Wersje
.NET 9

WriteLine(String, Object[])

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje reprezentację tekstową określonej tablicy obiektów, po której następuje bieżący terminator wiersza, do standardowego strumienia wyjściowego przy użyciu określonych informacji o formacie.

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

Parametry

format
String

Ciąg formatu złożonego.

arg
Object[]

Tablica obiektów do zapisu przy użyciu format.

Wyjątki

IOException

Wystąpił błąd we/wy.

ArgumentNullException

format lub arg jest null.

FormatException

Specyfikacja formatu w format jest nieprawidłowa.

Przykłady

W poniższym przykładzie przedstawiono standardowe specyfikatory formatowania liczb, dat i wyliczenia.

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

*/

Poniższy przykład to kalkulator wskazówek, który oblicza 18% poradę i używa metody WriteLine, aby wyświetlić kwotę oryginalnego opłaty, kwotę końcówki i łączną kwotę. Przykładem jest aplikacja konsolowa, która wymaga od użytkownika podania kwoty oryginalnej opłaty jako parametru wiersza polecenia.

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

Uwagi

Ta metoda używa funkcji formatowania złożonego platformy .NET, aby przekonwertować wartość obiektu na jego reprezentację tekstową i osadzić tę reprezentację w ciągu. Wynikowy ciąg jest zapisywany w strumieniu wyjściowym.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektowi na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu tekstem reprezentującym wartość odpowiedniego obiektu.

Składnią elementu formatu jest {indeks[,wyrównania][:formatString]}, który określa obowiązkowy indeks, opcjonalną długość i wyrównanie sformatowanego tekstu oraz opcjonalny ciąg znaków specyfikatora formatu, które określają sposób formatowania wartości odpowiedniego obiektu.

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w poniższych tematach formatowania.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Uwagi dotyczące wywoływania

Ta metoda nie jest wywoływana przez kod C++. Kompilator języka C++ rozpoznaje wywołania System.Console.WriteLine, które zawierają ciąg i listę czterech lub więcej parametrów obiektu jako wywołanie WriteLine(String, Object, Object, Object, Object). Rozwiązuje ona wywołania System.Console.WriteLine, które zawierają ciąg i tablicę obiektów jako wywołanie WriteLine(String, Object).

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje reprezentację tekstową określonego obiektu, po którym następuje bieżący terminator wiersza, do standardowego strumienia wyjściowego przy użyciu określonych informacji o formacie.

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

Parametry

format
String

Ciąg formatu złożonego.

arg0
Object

Obiekt do zapisu przy użyciu format.

Wyjątki

IOException

Wystąpił błąd we/wy.

ArgumentNullException

format jest null.

FormatException

Specyfikacja formatu w format jest nieprawidłowa.

Przykłady

Poniższy przykład wywołuje metodę WriteLine(String, Object), aby wyświetlić pięć losowo wygenerowanych wartości Boolean.

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

Poniższy przykład wywołuje metodę WriteLine(String, Object), aby wyświetlić bieżącą datę. Należy pamiętać, że element formatu w argumencie format używa ciągu formatu "D" standardowego ciągu daty i godziny, aby wyświetlić datę w formacie daty długiej bieżącej kultury.

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

Uwagi

Ta metoda używa funkcji formatowania złożonego platformy .NET, aby przekonwertować wartość obiektu na jego reprezentację tekstową i osadzić tę reprezentację w ciągu. Wynikowy ciąg jest zapisywany w strumieniu wyjściowym.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektowi na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu tekstem reprezentującym wartość odpowiedniego obiektu.

Składnią elementu formatu jest {indeks[,wyrównania][:formatString]}, który określa obowiązkowy indeks, opcjonalną długość i wyrównanie sformatowanego tekstu oraz opcjonalny ciąg znaków specyfikatora formatu, które określają sposób formatowania wartości odpowiedniego obiektu.

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w poniższych tematach formatowania.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Zapisuje reprezentację tekstową określonej 64-bitowej niepodpisanej wartości całkowitej, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.

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

Parametry

value
UInt64

Wartość do zapisania.

Atrybuty
CLSCompliantAttribute

Wyjątki

IOException

Wystąpił błąd we/wy.

Przykłady

Poniższy przykład to kalkulator wskazówek, który oblicza 18% poradę i używa metody WriteLine, aby wyświetlić kwotę oryginalnego opłaty, kwotę końcówki i łączną kwotę. Przykładem jest aplikacja konsolowa, która wymaga od użytkownika podania kwoty oryginalnej opłaty jako parametru wiersza polecenia.

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

Uwagi

Tekstowa reprezentacja value jest generowany przez wywołanie metody UInt64.ToString.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Zapisuje tekstową reprezentację określonej 32-bitowej niepodpisanej wartości całkowitej, po której następuje bieżący terminator wiersza, do standardowego strumienia wyjściowego.

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

Parametry

value
UInt32

Wartość do zapisania.

Atrybuty
CLSCompliantAttribute

Wyjątki

IOException

Wystąpił błąd we/wy.

Przykłady

Poniższy przykład to kalkulator wskazówek, który oblicza 18% poradę i używa metody WriteLine, aby wyświetlić kwotę oryginalnego opłaty, kwotę końcówki i łączną kwotę. Przykładem jest aplikacja konsolowa, która wymaga od użytkownika podania kwoty oryginalnej opłaty jako parametru wiersza polecenia.

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

Uwagi

Tekstowa reprezentacja value jest generowany przez wywołanie metody UInt32.ToString.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje reprezentację tekstową określonej wartości zmiennoprzecinkowej o pojedynczej precyzji, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.

C# 
public static void WriteLine (float value);

Parametry

value
Single

Wartość do zapisania.

Wyjątki

IOException

Wystąpił błąd we/wy.

Przykłady

Poniższy przykład to kalkulator wskazówek, który oblicza 18% poradę i używa metody WriteLine, aby wyświetlić kwotę oryginalnego opłaty, kwotę końcówki i łączną kwotę. Przykładem jest aplikacja konsolowa, która wymaga od użytkownika podania kwoty oryginalnej opłaty jako parametru wiersza polecenia.

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

Uwagi

Tekstowa reprezentacja value jest generowany przez wywołanie metody Single.ToString.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje reprezentację tekstową określonej wartości zmiennoprzecinkowej o podwójnej precyzji, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.

C# 
public static void WriteLine (double value);

Parametry

value
Double

Wartość do zapisania.

Wyjątki

IOException

Wystąpił błąd we/wy.

Przykłady

Poniższy przykład to kalkulator wskazówek, który oblicza 18% poradę i używa metody WriteLine, aby wyświetlić kwotę oryginalnego opłaty, kwotę końcówki i łączną kwotę. Przykładem jest aplikacja konsolowa, która wymaga od użytkownika podania kwoty oryginalnej opłaty jako parametru wiersza polecenia.

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

Uwagi

Tekstowa reprezentacja value jest generowany przez wywołanie metody Double.ToString.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje tekstową reprezentację określonej 64-bitowej liczby całkowitej ze znakiem, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.

C# 
public static void WriteLine (long value);

Parametry

value
Int64

Wartość do zapisania.

Wyjątki

IOException

Wystąpił błąd we/wy.

Przykłady

Poniższy przykład to kalkulator wskazówek, który oblicza 18% poradę i używa metody WriteLine, aby wyświetlić kwotę oryginalnego opłaty, kwotę końcówki i łączną kwotę. Przykładem jest aplikacja konsolowa, która wymaga od użytkownika podania kwoty oryginalnej opłaty jako parametru wiersza polecenia.

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

Uwagi

Tekstowa reprezentacja value jest generowany przez wywołanie metody Int64.ToString.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje tekstową reprezentację określonej 32-bitowej liczby całkowitej ze znakiem, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.

C# 
public static void WriteLine (int value);

Parametry

value
Int32

Wartość do zapisania.

Wyjątki

IOException

Wystąpił błąd we/wy.

Przykłady

Poniższy przykład to kalkulator wskazówek, który oblicza 18% poradę i używa metody WriteLine, aby wyświetlić kwotę oryginalnego opłaty, kwotę końcówki i łączną kwotę. Przykładem jest aplikacja konsolowa, która wymaga od użytkownika podania kwoty oryginalnej opłaty jako parametru wiersza polecenia.

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

Uwagi

Tekstowa reprezentacja value jest generowany przez wywołanie metody Int32.ToString.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje tekstową reprezentację określonej wartości Decimal, po której następuje bieżący terminator wiersza, do standardowego strumienia wyjściowego.

C# 
public static void WriteLine (decimal value);

Parametry

value
Decimal

Wartość do zapisania.

Wyjątki

IOException

Wystąpił błąd we/wy.

Przykłady

Poniższy przykład to kalkulator wskazówek, który oblicza 18% poradę i używa metody WriteLine, aby wyświetlić kwotę oryginalnego opłaty, kwotę końcówki i łączną kwotę. Przykładem jest aplikacja konsolowa, która wymaga od użytkownika podania kwoty oryginalnej opłaty jako parametru wiersza polecenia.

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

Uwagi

Tekstowa reprezentacja value jest generowany przez wywołanie metody Decimal.ToString.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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[])

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje określoną tablicę znaków Unicode, po której następuje bieżący terminator wiersza, do standardowego strumienia wyjściowego.

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

Parametry

buffer
Char[]

Tablica znaków Unicode.

Wyjątki

IOException

Wystąpił błąd we/wy.

Uwagi

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje określony znak Unicode, po którym następuje bieżący terminator wiersza, wartość standardowego strumienia wyjściowego.

C# 
public static void WriteLine (char value);

Parametry

value
Char

Wartość do zapisania.

Wyjątki

IOException

Wystąpił błąd we/wy.

Przykłady

Poniższy przykład to kalkulator wskazówek, który oblicza 18% poradę i używa metody WriteLine, aby wyświetlić kwotę oryginalnego opłaty, kwotę końcówki i łączną kwotę. Przykładem jest aplikacja konsolowa, która wymaga od użytkownika podania kwoty oryginalnej opłaty jako parametru wiersza polecenia.

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

Uwagi

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje tekstową reprezentację określonej wartości logicznej, a następnie bieżący terminator wiersza do standardowego strumienia wyjściowego.

C# 
public static void WriteLine (bool value);

Parametry

value
Boolean

Wartość do zapisania.

Wyjątki

IOException

Wystąpił błąd we/wy.

Przykłady

Poniższy przykład generuje dziesięć losowych liczb całkowitych i używa metody Console.WriteLine(Boolean), aby wskazać, czy są równe.

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

Uwagi

Tekstowa reprezentacja value jest generowany przez wywołanie metody Boolean.ToString.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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()

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje bieżący terminator wiersza w standardowym strumieniu wyjściowym.

C# 
public static void WriteLine ();

Wyjątki

IOException

Wystąpił błąd we/wy.

Przykłady

Przykład zmienia terminator wiersza z domyślnej wartości "\r\n" lub vbCrLf na "\r\n\r\n" lub vbCrLf + vbCrLf. Następnie wywołuje metody WriteLine() i WriteLine(String), aby wyświetlić dane wyjściowe w konsoli.

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.

Uwagi

Domyślny terminator wiersza to ciąg, którego wartość jest zwracanym karetkiem, po którym następuje źródło wiersza ("\r\n" w języku C#, lub vbCrLf w Visual Basic). Terminator wiersza można zmienić, ustawiając właściwość TextWriter.NewLine właściwości Out na inny ciąg. Przykład zawiera ilustrację.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje reprezentację tekstową określonych obiektów, a następnie bieżący terminator wiersza, do standardowego strumienia wyjściowego przy użyciu określonych informacji o formacie.

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

Parametry

format
String

Ciąg formatu złożonego.

arg0
Object

Pierwszy obiekt do zapisu przy użyciu format.

arg1
Object

Drugi obiekt do zapisu przy użyciu format.

arg2
Object

Trzeci obiekt do zapisu przy użyciu format.

Wyjątki

IOException

Wystąpił błąd we/wy.

ArgumentNullException

format jest null.

FormatException

Specyfikacja formatu w format jest nieprawidłowa.

Przykłady

W poniższym przykładzie przedstawiono standardowe specyfikatory formatowania liczb, dat i wyliczenia.

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

*/

Poniższy przykład to kalkulator wskazówek, który oblicza 18% poradę i używa metody WriteLine, aby wyświetlić kwotę oryginalnego opłaty, kwotę końcówki i łączną kwotę. Przykładem jest aplikacja konsolowa, która wymaga od użytkownika podania kwoty oryginalnej opłaty jako parametru wiersza polecenia.

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

Uwagi

Ta metoda używa funkcji formatowania złożonego platformy .NET, aby przekonwertować wartość obiektu na jego reprezentację tekstową i osadzić tę reprezentację w ciągu. Wynikowy ciąg jest zapisywany w strumieniu wyjściowym.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektowi na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu tekstem reprezentującym wartość odpowiedniego obiektu.

Składnią elementu formatu jest {indeks[,wyrównania][:formatString]}, który określa obowiązkowy indeks, opcjonalną długość i wyrównanie sformatowanego tekstu oraz opcjonalny ciąg znaków specyfikatora formatu, które określają sposób formatowania wartości odpowiedniego obiektu.

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w poniższych tematach formatowania.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Źródło:
Console.cs
Źródło:
Console.cs
Źródło:
Console.cs

Zapisuje reprezentację tekstową określonego obiektu, po którym następuje bieżący terminator wiersza, do standardowego strumienia wyjściowego.

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

Parametry

value
Object

Wartość do zapisania.

Wyjątki

IOException

Wystąpił błąd we/wy.

Przykłady

W poniższym przykładzie użyto metody WriteLine(Object) do wyświetlenia każdej wartości w tablicy obiektów w konsoli programu .

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

Uwagi

Jeśli value jest null, zapisywany jest tylko terminator wiersza. W przeciwnym razie metoda ToStringvalue jest wywoływana w celu utworzenia reprezentacji ciągu, a wynikowy ciąg jest zapisywany w standardowym strumieniu wyjściowym.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.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)

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Zapisuje tekstową reprezentację określonych obiektów i listy parametrów o zmiennej długości, a następnie bieżący terminator wiersza, do standardowego strumienia wyjściowego przy użyciu określonych informacji o formacie.

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

Parametry

format
String

Ciąg formatu złożonego.

arg0
Object

Pierwszy obiekt do zapisu przy użyciu format.

arg1
Object

Drugi obiekt do zapisu przy użyciu format.

arg2
Object

Trzeci obiekt do zapisu przy użyciu format.

arg3
Object

Czwarty obiekt do zapisu przy użyciu format.

Atrybuty
CLSCompliantAttribute

Wyjątki

IOException

Wystąpił błąd we/wy.

ArgumentNullException

format jest null.

FormatException

Specyfikacja formatu w format jest nieprawidłowa.

Przykłady

Poniższy przykład ilustruje użycie argumentów zmiennych z metodą WriteLine(String, Object, Object, Object, Object). Metoda jest wywoływana z ciągiem formatu złożonego i pięcioma elementami formatu.

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

Uwagi

Uwaga

Ten interfejs API nie jest zgodny ze specyfikacją CLS. Alternatywą zgodną ze specyfikacją CLS jest Console.WriteLine(String, Object[]). Kompilatory języka C# i Visual Basic automatycznie rozpoznają wywołanie tej metody jako wywołanie metody Console.WriteLine(String, Object[]).

Ta metoda używa funkcji formatowania złożonego platformy .NET, aby przekonwertować wartość obiektu na jego reprezentację tekstową i osadzić tę reprezentację w ciągu. Wynikowy ciąg jest zapisywany w strumieniu wyjściowym.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektowi na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu tekstem reprezentującym wartość odpowiedniego obiektu.

Składnią elementu formatu jest {indeks[,wyrównania][:formatString]}, który określa obowiązkowy indeks, opcjonalną długość i wyrównanie sformatowanego tekstu oraz opcjonalny ciąg znaków specyfikatora formatu, które określają sposób formatowania wartości odpowiedniego obiektu.

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w poniższych tematach formatowania.

Aby uzyskać więcej informacji na temat terminatora wiersza, zobacz sekcję Uwagi metody WriteLine, która nie przyjmuje parametrów.

Uwagi dotyczące wywoływania

Ta metoda jest oznaczona za pomocą słowa kluczowego vararg, co oznacza, że obsługuje zmienną liczbę parametrów. Metodę można wywołać z języka Visual C++, ale nie można jej wywołać z poziomu kodu C# lub Visual Basic. Kompilatory języka C# i Visual Basic rozwiązują wywołania WriteLine(String, Object, Object, Object, Object) jako wywołania WriteLine(String, Object[]).

Zobacz też

Dotyczy

.NET Framework 4.8.1 i inne wersje
Produkt Wersje
.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