Auf Englisch lesen

Freigeben über

Console.WriteLine Methode

  • Referenz

Definition

Namespace:
System
Assembly:
System.Console.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Schreibt die angegebenen Daten, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.

Überlädt

WriteLine(String, Object, Object)

Schreibt die Textdarstellung der angegebenen Objekte, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom mithilfe der angegebenen Formatinformationen.
WriteLine(String)

Schreibt den angegebenen Zeichenfolgenwert, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.
WriteLine(Char[], Int32, Int32)

Schreibt die angegebene Unterarray von Unicode-Zeichen, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.
WriteLine(String, ReadOnlySpan<Object>)

Schreibt die Textdarstellung der angegebenen Objektspanne, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom mithilfe der angegebenen Formatinformationen.
WriteLine(String, Object[])

Schreibt die Textdarstellung des angegebenen Arrays von Objekten, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom mithilfe der angegebenen Formatinformationen.
WriteLine(String, Object)

Schreibt die Textdarstellung des angegebenen Objekts, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom mithilfe der angegebenen Formatinformationen.
WriteLine(UInt64)

Schreibt die Textdarstellung des angegebenen ganzzahligen 64-Bit-Werts ohne Vorzeichen, gefolgt vom aktuellen Zeilenende, in den Standardausgabedatenstrom.
WriteLine(UInt32)

Schreibt die Textdarstellung des angegebenen 32-Bit-Ganzzahlwerts ohne Vorzeichen gefolgt vom aktuellen Zeilenende in den Standardausgabedatenstrom.
WriteLine(Single)

Schreibt die Textdarstellung des angegebenen Gleitkommawerts mit einfacher Genauigkeit, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.
WriteLine(Double)

Schreibt die Textdarstellung des angegebenen Gleitkommawerts mit doppelter Genauigkeit, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.
WriteLine(Int64)

Schreibt die Textdarstellung des angegebenen ganzzahligen 64-Bit-Werts mit Vorzeichen, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.
WriteLine(Int32)

Schreibt die Textdarstellung des angegebenen ganzzahligen 32-Bit-Werts mit Vorzeichen, gefolgt vom aktuellen Zeilenendpunkt, in den Standardausgabedatenstrom.
WriteLine(Decimal)

Schreibt die Textdarstellung des angegebenen Decimal Werts, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.
WriteLine(Char[])

Schreibt das angegebene Array von Unicode-Zeichen, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.
WriteLine(Char)

Schreibt das angegebene Unicode-Zeichen, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.
WriteLine(Boolean)

Schreibt die Textdarstellung des angegebenen booleschen Werts, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.
WriteLine()

Schreibt den aktuellen Zeilenendpunkt in den Standardausgabedatenstrom.
WriteLine(String, Object, Object, Object)

Schreibt die Textdarstellung der angegebenen Objekte, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom mithilfe der angegebenen Formatinformationen.
WriteLine(Object)

Schreibt die Textdarstellung des angegebenen Objekts, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.
WriteLine(String, Object, Object, Object, Object)

Schreibt die Textdarstellung der angegebenen Objekte und der Parameterliste variabler Länge, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom mithilfe der angegebenen Formatinformationen.

Hinweise

Der Standardzeilenterminator ist eine Zeichenfolge, deren Wert ein Wagenrücklauf ist, gefolgt von einem Zeilenvorschub ("\r\n" in C# oder vbCrLf in Visual Basic). Sie können den Zeilenterminator ändern, indem Sie die eigenschaft TextWriter.NewLine der Out-Eigenschaft auf eine andere Zeichenfolge festlegen.

WriteLine(String, Object, Object)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt die Textdarstellung der angegebenen Objekte, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom mithilfe der angegebenen Formatinformationen.

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

Parameter

format
String

Eine zusammengesetzte Formatzeichenfolge.

arg0
Object

Das erste Objekt, das mit formatgeschrieben werden soll.

arg1
Object

Das zweite Objekt, das mit formatgeschrieben werden soll.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

ArgumentNullException

format ist null.

FormatException

Die Formatspezifikation in format ist ungültig.

Beispiele

Das folgende Beispiel veranschaulicht die Standardformatierungsbezeichner für Zahlen, Datumsangaben und Enumerationen.

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

*/

Das folgende Beispiel ist ein Tipprechner, der eine 18% Tipp berechnet und die WriteLine-Methode verwendet, um den Betrag der ursprünglichen Gebühr, den Betrag der Spitze und den Gesamtbetrag anzuzeigen. Das Beispiel ist eine Konsolenanwendung, die erfordert, dass der Benutzer den Betrag der ursprünglichen Belastung als Befehlszeilenparameter angibt.

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

Hinweise

Diese Methode verwendet das zusammengesetzte Formatierungsfeature von .NET, um den Wert eines Objekts in seine Textdarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. Die resultierende Zeichenfolge wird in den Ausgabedatenstrom geschrieben.

Der format-Parameter besteht aus null oder mehr Textläufen, die mit Null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, miteinander verknüpft sind, die einem Objekt in der Parameterliste dieser Methode entsprechen. Der Formatierungsprozess ersetzt jedes Formatelement durch die Textdarstellung des Werts des entsprechenden Objekts.

Die Syntax eines Formatelements ist {Index[,Ausrichtung][:formatString]}), der einen obligatorischen Index angibt, die optionale Länge und Ausrichtung des formatierten Texts sowie eine optionale Zeichenfolge mit Formatbezeichnerzeichen, die steuern, wie der Wert des entsprechenden Objekts formatiert ist.

.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt den angegebenen Zeichenfolgenwert, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.

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

Parameter

value
String

Der zu schreibende Wert.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

Beispiele

Im Beispiel wird der Zeilenendpunkt aus dem Standardwert "\r\n" oder vbCrLf in "\r\n\r\n" oder "vbCrLf + vbCrLf" geändert. Anschließend werden die methoden WriteLine() und WriteLine(String) aufgerufen, um die Ausgabe in der Konsole anzuzeigen.

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.

Hinweise

Wenn der Wert nullist, wird nur der Zeilenterminator in den Standardausgabedatenstrom geschrieben.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine()-Methode.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt die angegebene Unterarray von Unicode-Zeichen, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.

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

Parameter

buffer
Char[]

Ein Array von Unicode-Zeichen.

index
Int32

Die Anfangsposition in buffer.

count
Int32

Die Anzahl der zu schreibenden Zeichen.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentOutOfRangeException

index oder count ist kleiner als Null.

ArgumentException

index plus count eine Position angeben, die sich nicht innerhalb bufferbefindet.

IOException

Ein E/A-Fehler ist aufgetreten.

Hinweise

Diese Methode schreibt count Zeichen beginnend an position index von buffer in den Standardausgabedatenstrom.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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>)

Schreibt die Textdarstellung der angegebenen Objektspanne, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom mithilfe der angegebenen Formatinformationen.

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

Parameter

format
String

Eine zusammengesetzte Formatzeichenfolge.

arg
ReadOnlySpan<Object>

Eine Spanne von Objekten, die mit dem Format geschrieben werden sollen.

Gilt für:

.NET 9
Produkt Versionen
.NET 9

WriteLine(String, Object[])

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt die Textdarstellung des angegebenen Arrays von Objekten, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom mithilfe der angegebenen Formatinformationen.

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

Parameter

format
String

Eine zusammengesetzte Formatzeichenfolge.

arg
Object[]

Ein Array von Objekten, die mit formatgeschrieben werden sollen.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

ArgumentNullException

format oder arg ist null.

FormatException

Die Formatspezifikation in format ist ungültig.

Beispiele

Das folgende Beispiel veranschaulicht die Standardformatierungsbezeichner für Zahlen, Datumsangaben und Enumerationen.

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

*/

Das folgende Beispiel ist ein Tipprechner, der eine 18% Tipp berechnet und die WriteLine-Methode verwendet, um den Betrag der ursprünglichen Gebühr, den Betrag der Spitze und den Gesamtbetrag anzuzeigen. Das Beispiel ist eine Konsolenanwendung, die erfordert, dass der Benutzer den Betrag der ursprünglichen Belastung als Befehlszeilenparameter angibt.

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

Hinweise

Diese Methode verwendet das zusammengesetzte Formatierungsfeature von .NET, um den Wert eines Objekts in seine Textdarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. Die resultierende Zeichenfolge wird in den Ausgabedatenstrom geschrieben.

Der format-Parameter besteht aus null oder mehr Textläufen, die mit Null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, miteinander verknüpft sind, die einem Objekt in der Parameterliste dieser Methode entsprechen. Der Formatierungsprozess ersetzt jedes Formatelement durch die Textdarstellung des Werts des entsprechenden Objekts.

Die Syntax eines Formatelements ist {Index[,Ausrichtung][:formatString]}), der einen obligatorischen Index angibt, die optionale Länge und Ausrichtung des formatierten Texts sowie eine optionale Zeichenfolge mit Formatbezeichnerzeichen, die steuern, wie der Wert des entsprechenden Objekts formatiert ist.

.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Hinweise für Aufrufer

Diese Methode wird nicht vom C++-Code aufgerufen. Der C++-Compiler löst Aufrufe von System.Console.WriteLine- auf, die eine Zeichenfolge und eine Liste mit vier oder mehr Objektparametern als Aufruf von WriteLine(String, Object, Object, Object, Object)enthalten. Es löst Aufrufe von System.Console.WriteLine-, die eine Zeichenfolge und ein Objektarray als Aufruf von WriteLine(String, Object)enthalten.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt die Textdarstellung des angegebenen Objekts, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom mithilfe der angegebenen Formatinformationen.

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

Parameter

format
String

Eine zusammengesetzte Formatzeichenfolge.

arg0
Object

Ein Objekt, das mit formatgeschrieben werden soll.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

ArgumentNullException

format ist null.

FormatException

Die Formatspezifikation in format ist ungültig.

Beispiele

Im folgenden Beispiel wird die WriteLine(String, Object)-Methode aufgerufen, um fünf zufällig generierte Boolean Werte anzuzeigen.

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

Im folgenden Beispiel wird die WriteLine(String, Object)-Methode aufgerufen, um das aktuelle Datum anzuzeigen. Beachten Sie, dass das Formatelement im argument format die Standardzeichenfolge für Datum und Uhrzeit verwendet, um das Datum im langen Datumsformat der aktuellen Kultur anzuzeigen.

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

Hinweise

Diese Methode verwendet das zusammengesetzte Formatierungsfeature von .NET, um den Wert eines Objekts in seine Textdarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. Die resultierende Zeichenfolge wird in den Ausgabedatenstrom geschrieben.

Der format-Parameter besteht aus null oder mehr Textläufen, die mit Null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, miteinander verknüpft sind, die einem Objekt in der Parameterliste dieser Methode entsprechen. Der Formatierungsprozess ersetzt jedes Formatelement durch die Textdarstellung des Werts des entsprechenden Objekts.

Die Syntax eines Formatelements ist {Index[,Ausrichtung][:formatString]}), der einen obligatorischen Index angibt, die optionale Länge und Ausrichtung des formatierten Texts sowie eine optionale Zeichenfolge mit Formatbezeichnerzeichen, die steuern, wie der Wert des entsprechenden Objekts formatiert ist.

.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Schreibt die Textdarstellung des angegebenen ganzzahligen 64-Bit-Werts ohne Vorzeichen, gefolgt vom aktuellen Zeilenende, in den Standardausgabedatenstrom.

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

Parameter

value
UInt64

Der zu schreibende Wert.

Attribute
CLSCompliantAttribute

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

Beispiele

Das folgende Beispiel ist ein Tipprechner, der eine 18% Tipp berechnet und die WriteLine-Methode verwendet, um den Betrag der ursprünglichen Gebühr, den Betrag der Spitze und den Gesamtbetrag anzuzeigen. Das Beispiel ist eine Konsolenanwendung, die erfordert, dass der Benutzer den Betrag der ursprünglichen Belastung als Befehlszeilenparameter angibt.

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

Hinweise

Die Textdarstellung von value wird durch Aufrufen der UInt64.ToString-Methode erstellt.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Schreibt die Textdarstellung des angegebenen 32-Bit-Ganzzahlwerts ohne Vorzeichen gefolgt vom aktuellen Zeilenende in den Standardausgabedatenstrom.

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

Parameter

value
UInt32

Der zu schreibende Wert.

Attribute
CLSCompliantAttribute

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

Beispiele

Das folgende Beispiel ist ein Tipprechner, der eine 18% Tipp berechnet und die WriteLine-Methode verwendet, um den Betrag der ursprünglichen Gebühr, den Betrag der Spitze und den Gesamtbetrag anzuzeigen. Das Beispiel ist eine Konsolenanwendung, die erfordert, dass der Benutzer den Betrag der ursprünglichen Belastung als Befehlszeilenparameter angibt.

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

Hinweise

Die Textdarstellung von value wird durch Aufrufen der UInt32.ToString-Methode erstellt.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt die Textdarstellung des angegebenen Gleitkommawerts mit einfacher Genauigkeit, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.

C# 
public static void WriteLine (float value);

Parameter

value
Single

Der zu schreibende Wert.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

Beispiele

Das folgende Beispiel ist ein Tipprechner, der eine 18% Tipp berechnet und die WriteLine-Methode verwendet, um den Betrag der ursprünglichen Gebühr, den Betrag der Spitze und den Gesamtbetrag anzuzeigen. Das Beispiel ist eine Konsolenanwendung, die erfordert, dass der Benutzer den Betrag der ursprünglichen Belastung als Befehlszeilenparameter angibt.

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

Hinweise

Die Textdarstellung von value wird durch Aufrufen der Single.ToString-Methode erstellt.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt die Textdarstellung des angegebenen Gleitkommawerts mit doppelter Genauigkeit, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.

C# 
public static void WriteLine (double value);

Parameter

value
Double

Der zu schreibende Wert.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

Beispiele

Das folgende Beispiel ist ein Tipprechner, der eine 18% Tipp berechnet und die WriteLine-Methode verwendet, um den Betrag der ursprünglichen Gebühr, den Betrag der Spitze und den Gesamtbetrag anzuzeigen. Das Beispiel ist eine Konsolenanwendung, die erfordert, dass der Benutzer den Betrag der ursprünglichen Belastung als Befehlszeilenparameter angibt.

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

Hinweise

Die Textdarstellung von value wird durch Aufrufen der Double.ToString-Methode erstellt.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt die Textdarstellung des angegebenen ganzzahligen 64-Bit-Werts mit Vorzeichen, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.

C# 
public static void WriteLine (long value);

Parameter

value
Int64

Der zu schreibende Wert.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

Beispiele

Das folgende Beispiel ist ein Tipprechner, der eine 18% Tipp berechnet und die WriteLine-Methode verwendet, um den Betrag der ursprünglichen Gebühr, den Betrag der Spitze und den Gesamtbetrag anzuzeigen. Das Beispiel ist eine Konsolenanwendung, die erfordert, dass der Benutzer den Betrag der ursprünglichen Belastung als Befehlszeilenparameter angibt.

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

Hinweise

Die Textdarstellung von value wird durch Aufrufen der Int64.ToString-Methode erstellt.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt die Textdarstellung des angegebenen ganzzahligen 32-Bit-Werts mit Vorzeichen, gefolgt vom aktuellen Zeilenendpunkt, in den Standardausgabedatenstrom.

C# 
public static void WriteLine (int value);

Parameter

value
Int32

Der zu schreibende Wert.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

Beispiele

Das folgende Beispiel ist ein Tipprechner, der eine 18% Tipp berechnet und die WriteLine-Methode verwendet, um den Betrag der ursprünglichen Gebühr, den Betrag der Spitze und den Gesamtbetrag anzuzeigen. Das Beispiel ist eine Konsolenanwendung, die erfordert, dass der Benutzer den Betrag der ursprünglichen Belastung als Befehlszeilenparameter angibt.

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

Hinweise

Die Textdarstellung von value wird durch Aufrufen der Int32.ToString-Methode erstellt.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt die Textdarstellung des angegebenen Decimal Werts, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.

C# 
public static void WriteLine (decimal value);

Parameter

value
Decimal

Der zu schreibende Wert.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

Beispiele

Das folgende Beispiel ist ein Tipprechner, der eine 18% Tipp berechnet und die WriteLine-Methode verwendet, um den Betrag der ursprünglichen Gebühr, den Betrag der Spitze und den Gesamtbetrag anzuzeigen. Das Beispiel ist eine Konsolenanwendung, die erfordert, dass der Benutzer den Betrag der ursprünglichen Belastung als Befehlszeilenparameter angibt.

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

Hinweise

Die Textdarstellung von value wird durch Aufrufen der Decimal.ToString-Methode erstellt.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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[])

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt das angegebene Array von Unicode-Zeichen, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.

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

Parameter

buffer
Char[]

Ein Unicode-Zeichenarray.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

Hinweise

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt das angegebene Unicode-Zeichen, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.

C# 
public static void WriteLine (char value);

Parameter

value
Char

Der zu schreibende Wert.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

Beispiele

Das folgende Beispiel ist ein Tipprechner, der eine 18% Tipp berechnet und die WriteLine-Methode verwendet, um den Betrag der ursprünglichen Gebühr, den Betrag der Spitze und den Gesamtbetrag anzuzeigen. Das Beispiel ist eine Konsolenanwendung, die erfordert, dass der Benutzer den Betrag der ursprünglichen Belastung als Befehlszeilenparameter angibt.

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

Hinweise

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt die Textdarstellung des angegebenen booleschen Werts, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.

C# 
public static void WriteLine (bool value);

Parameter

value
Boolean

Der zu schreibende Wert.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

Beispiele

Im folgenden Beispiel werden zehn ganzzahlige Zufallszahlen generiert und die Console.WriteLine(Boolean) Methode verwendet, um anzugeben, ob sie sogar vorhanden sind.

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

Hinweise

Die Textdarstellung von value wird durch Aufrufen der Boolean.ToString-Methode erstellt.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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()

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt den aktuellen Zeilenendpunkt in den Standardausgabedatenstrom.

C# 
public static void WriteLine ();

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

Beispiele

Im Beispiel wird der Zeilenendpunkt aus dem Standardwert "\r\n" oder vbCrLf in "\r\n\r\n" oder "vbCrLf + vbCrLf" geändert. Anschließend werden die methoden WriteLine() und WriteLine(String) aufgerufen, um die Ausgabe in der Konsole anzuzeigen.

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.

Hinweise

Der Standardzeilenterminator ist eine Zeichenfolge, deren Wert ein Wagenrücklauf ist, gefolgt von einem Zeilenvorschub ("\r\n" in C# oder vbCrLf in Visual Basic). Sie können den Zeilenterminator ändern, indem Sie die eigenschaft TextWriter.NewLine der Out-Eigenschaft auf eine andere Zeichenfolge festlegen. Das Beispiel stellt eine Abbildung bereit.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt die Textdarstellung der angegebenen Objekte, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom mithilfe der angegebenen Formatinformationen.

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

Parameter

format
String

Eine zusammengesetzte Formatzeichenfolge.

arg0
Object

Das erste Objekt, das mit formatgeschrieben werden soll.

arg1
Object

Das zweite Objekt, das mit formatgeschrieben werden soll.

arg2
Object

Das dritte Objekt, das mit formatgeschrieben werden soll.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

ArgumentNullException

format ist null.

FormatException

Die Formatspezifikation in format ist ungültig.

Beispiele

Das folgende Beispiel veranschaulicht die Standardformatierungsbezeichner für Zahlen, Datumsangaben und Enumerationen.

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

*/

Das folgende Beispiel ist ein Tipprechner, der eine 18% Tipp berechnet und die WriteLine-Methode verwendet, um den Betrag der ursprünglichen Gebühr, den Betrag der Spitze und den Gesamtbetrag anzuzeigen. Das Beispiel ist eine Konsolenanwendung, die erfordert, dass der Benutzer den Betrag der ursprünglichen Belastung als Befehlszeilenparameter angibt.

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

Hinweise

Diese Methode verwendet das zusammengesetzte Formatierungsfeature von .NET, um den Wert eines Objekts in seine Textdarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. Die resultierende Zeichenfolge wird in den Ausgabedatenstrom geschrieben.

Der format-Parameter besteht aus null oder mehr Textläufen, die mit Null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, miteinander verknüpft sind, die einem Objekt in der Parameterliste dieser Methode entsprechen. Der Formatierungsprozess ersetzt jedes Formatelement durch die Textdarstellung des Werts des entsprechenden Objekts.

Die Syntax eines Formatelements ist {Index[,Ausrichtung][:formatString]}), der einen obligatorischen Index angibt, die optionale Länge und Ausrichtung des formatierten Texts sowie eine optionale Zeichenfolge mit Formatbezeichnerzeichen, die steuern, wie der Wert des entsprechenden Objekts formatiert ist.

.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Schreibt die Textdarstellung des angegebenen Objekts, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom.

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

Parameter

value
Object

Der zu schreibende Wert.

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

Beispiele

Im folgenden Beispiel wird die WriteLine(Object)-Methode verwendet, um jeden Wert in einem Objektarray auf der Konsole anzuzeigen.

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

Hinweise

Wenn valuenullist, wird nur der Zeilenterminator geschrieben. Andernfalls wird die ToString-Methode von value aufgerufen, um die Zeichenfolgendarstellung zu erzeugen, und die resultierende Zeichenfolge wird in den Standardausgabedatenstrom geschrieben.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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)

Wichtig

Diese API ist nicht CLS-kompatibel.

Schreibt die Textdarstellung der angegebenen Objekte und der Parameterliste variabler Länge, gefolgt vom aktuellen Zeilenterminator, in den Standardausgabedatenstrom mithilfe der angegebenen Formatinformationen.

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

Parameter

format
String

Eine zusammengesetzte Formatzeichenfolge.

arg0
Object

Das erste Objekt, das mit formatgeschrieben werden soll.

arg1
Object

Das zweite Objekt, das mit formatgeschrieben werden soll.

arg2
Object

Das dritte Objekt, das mit formatgeschrieben werden soll.

arg3
Object

Das vierte Objekt, das mit formatgeschrieben werden soll.

Attribute
CLSCompliantAttribute

Ausnahmen

IOException

Ein E/A-Fehler ist aufgetreten.

ArgumentNullException

format ist null.

FormatException

Die Formatspezifikation in format ist ungültig.

Beispiele

Im folgenden Beispiel wird die Verwendung von Variablenargumenten mit der WriteLine(String, Object, Object, Object, Object)-Methode veranschaulicht. Die Methode wird mit einer zusammengesetzten Formatzeichenfolge und fünf Formatelementen aufgerufen.

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

Hinweise

Hinweis

Diese API ist nicht CLS-kompatibel. Die CLS-kompatible Alternative ist Console.WriteLine(String, Object[]). Die C#- und Visual Basic-Compiler lösen automatisch einen Aufruf dieser Methode als Aufruf von Console.WriteLine(String, Object[])auf.

Diese Methode verwendet das zusammengesetzte Formatierungsfeature von .NET, um den Wert eines Objekts in seine Textdarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. Die resultierende Zeichenfolge wird in den Ausgabedatenstrom geschrieben.

Der format-Parameter besteht aus null oder mehr Textläufen, die mit Null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, miteinander verknüpft sind, die einem Objekt in der Parameterliste dieser Methode entsprechen. Der Formatierungsprozess ersetzt jedes Formatelement durch die Textdarstellung des Werts des entsprechenden Objekts.

Die Syntax eines Formatelements ist {Index[,Ausrichtung][:formatString]}), der einen obligatorischen Index angibt, die optionale Länge und Ausrichtung des formatierten Texts sowie eine optionale Zeichenfolge mit Formatbezeichnerzeichen, die steuern, wie der Wert des entsprechenden Objekts formatiert ist.

.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird.

Weitere Informationen zum Zeilenendpunkt finden Sie im Abschnitt "Hinweise" der WriteLine-Methode, die keine Parameter akzeptiert.

Hinweise für Aufrufer

Diese Methode ist mit dem schlüsselwort vararg gekennzeichnet, was bedeutet, dass sie eine variable Anzahl von Parametern unterstützt. Die Methode kann aus Visual C++ aufgerufen werden, kann aber nicht aus C# oder Visual Basic-Code aufgerufen werden. Die C#- und Visual Basic-Compiler lösen Aufrufe von WriteLine(String, Object, Object, Object, Object) als Aufrufe von WriteLine(String, Object[])auf.

Weitere Informationen

Gilt für:

.NET Framework 4.8.1 und andere Versionen
Produkt Versionen
.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