Console.WriteLine Метод

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

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

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

Параметры

Исключения

Примеры

В следующем примере показаны стандартные описатели форматирования для чисел, дат и перечислений.

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

*/

В следующем примере приведен калькулятор чаевых, который вычисляет 18% подсказки и использует метод WriteLine для отображения суммы исходной платы, суммы чаевых и суммы. Примером является консольное приложение, которое требует от пользователя предоставить сумму исходной платы в качестве параметра командной строки.

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

Комментарии

Этот метод использует функцию составного форматирования .NET, чтобы преобразовать значение объекта в текстовое представление и внедрить это представление в строку. Результирующая строка записывается в выходной поток.

Параметр format состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент форматирования текстовым представлением значения соответствующего объекта.

Синтаксис элемента форматирования — это {индексов[,выравнивание][:formatString] ]}, который задает обязательный индекс, необязательную длину и выравнивание форматированного текста, а также необязательную строку символов описателя формата, которая управляет форматированием соответствующего объекта.

.NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования.

• Дополнительные сведения о функции составного форматирования, поддерживаемой такими методами, как Format, AppendFormatи некоторые перегрузки WriteLine, см. в составных.

• Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.

• Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.

• Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.

• Дополнительные сведения о форматировании см. в типов форматирования.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)
• Типы форматирования в .NET
• составное форматирование

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

public static void WriteLine (string? value);

public static void WriteLine (string value);

Параметры

Исключения

Примеры

В примере изменяется терминатор строки из значения по умолчанию "\r\n" или vbCrLf на "\r\n\r\n" или vbCrLf + vbCrLf. Затем он вызывает методы WriteLine() и WriteLine(String) для отображения выходных данных в консоли.

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.

Комментарии

Если значение null, в стандартный выходной поток записывается только терминатор строки.

Дополнительные сведения о терминаторе строки см. в разделе "Примечания" метода WriteLine().

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

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

Параметры

Исключения

Комментарии

Этот метод записывает count символы, начиная с позиции indexbuffer в стандартный выходной поток.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)

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

Параметры

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

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

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

Параметры

Исключения

Примеры

В следующем примере показаны стандартные описатели форматирования для чисел, дат и перечислений.

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

*/

В следующем примере приведен калькулятор чаевых, который вычисляет 18% подсказки и использует метод WriteLine для отображения суммы исходной платы, суммы чаевых и суммы. Примером является консольное приложение, которое требует от пользователя предоставить сумму исходной платы в качестве параметра командной строки.

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

Комментарии

Этот метод использует функцию составного форматирования .NET, чтобы преобразовать значение объекта в текстовое представление и внедрить это представление в строку. Результирующая строка записывается в выходной поток.

Параметр format состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент форматирования текстовым представлением значения соответствующего объекта.

Синтаксис элемента форматирования — это {индексов[,выравнивание][:formatString] ]}, который задает обязательный индекс, необязательную длину и выравнивание форматированного текста, а также необязательную строку символов описателя формата, которая управляет форматированием соответствующего объекта.

.NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования.

• Дополнительные сведения о функции составного форматирования, поддерживаемой такими методами, как Format, AppendFormatи некоторые перегрузки WriteLine, см. в составных.

• Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.

• Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.

• Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.

• Дополнительные сведения о форматировании см. в типов форматирования.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

Примечания для тех, кто вызывает этот метод

Этот метод не вызывается кодом C++. Компилятор C++ разрешает вызовы System.Console.WriteLine, которые включают строку и список четырех или более параметров объекта в качестве вызова WriteLine(String, Object, Object, Object, Object). Он разрешает вызовы System.Console.WriteLine, которые включают строку и массив объектов в качестве вызова WriteLine(String, Object).

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)
• Типы форматирования в .NET
• составное форматирование

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

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

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

Параметры

Исключения

Примеры

В следующем примере вызывается метод WriteLine(String, Object) для отображения пяти случайных Boolean значений.

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

В следующем примере вызывается метод WriteLine(String, Object) для отображения текущей даты. Обратите внимание, что элемент формата в аргументе format использует строку формата "D" стандартного формата даты и времени для отображения даты в формате длинной даты текущего языка и региональных параметров.

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

Комментарии

Этот метод использует функцию составного форматирования .NET, чтобы преобразовать значение объекта в текстовое представление и внедрить это представление в строку. Результирующая строка записывается в выходной поток.

Параметр format состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент форматирования текстовым представлением значения соответствующего объекта.

Синтаксис элемента форматирования — это {индексов[,выравнивание][:formatString] ]}, который задает обязательный индекс, необязательную длину и выравнивание форматированного текста, а также необязательную строку символов описателя формата, которая управляет форматированием соответствующего объекта.

.NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования.

• Дополнительные сведения о функции составного форматирования, поддерживаемой такими методами, как Format, AppendFormatи некоторые перегрузки WriteLine, см. в составных.

• Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.

• Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.

• Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.

• Дополнительные сведения о форматировании см. в типов форматирования.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)
• Типы форматирования в .NET
• составное форматирование

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

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

Параметры

Атрибуты

CLSCompliantAttribute

Исключения

Примеры

В следующем примере приведен калькулятор чаевых, который вычисляет 18% подсказки и использует метод WriteLine для отображения суммы исходной платы, суммы чаевых и суммы. Примером является консольное приложение, которое требует от пользователя предоставить сумму исходной платы в качестве параметра командной строки.

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

Комментарии

Текстовое представление value создается путем вызова метода UInt64.ToString.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

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

Параметры

Атрибуты

CLSCompliantAttribute

Исключения

Примеры

В следующем примере приведен калькулятор чаевых, который вычисляет 18% подсказки и использует метод WriteLine для отображения суммы исходной платы, суммы чаевых и суммы. Примером является консольное приложение, которое требует от пользователя предоставить сумму исходной платы в качестве параметра командной строки.

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

Комментарии

Текстовое представление value создается путем вызова метода UInt32.ToString.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

public static void WriteLine (float value);

Параметры

Исключения

Примеры

В следующем примере приведен калькулятор чаевых, который вычисляет 18% подсказки и использует метод WriteLine для отображения суммы исходной платы, суммы чаевых и суммы. Примером является консольное приложение, которое требует от пользователя предоставить сумму исходной платы в качестве параметра командной строки.

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

Комментарии

Текстовое представление value создается путем вызова метода Single.ToString.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

public static void WriteLine (double value);

Параметры

Исключения

Примеры

В следующем примере приведен калькулятор чаевых, который вычисляет 18% подсказки и использует метод WriteLine для отображения суммы исходной платы, суммы чаевых и суммы. Примером является консольное приложение, которое требует от пользователя предоставить сумму исходной платы в качестве параметра командной строки.

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

Комментарии

Текстовое представление value создается путем вызова метода Double.ToString.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

public static void WriteLine (long value);

Параметры

Исключения

Примеры

В следующем примере приведен калькулятор чаевых, который вычисляет 18% подсказки и использует метод WriteLine для отображения суммы исходной платы, суммы чаевых и суммы. Примером является консольное приложение, которое требует от пользователя предоставить сумму исходной платы в качестве параметра командной строки.

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

Комментарии

Текстовое представление value создается путем вызова метода Int64.ToString.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

public static void WriteLine (int value);

Параметры

Исключения

Примеры

В следующем примере приведен калькулятор чаевых, который вычисляет 18% подсказки и использует метод WriteLine для отображения суммы исходной платы, суммы чаевых и суммы. Примером является консольное приложение, которое требует от пользователя предоставить сумму исходной платы в качестве параметра командной строки.

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

Комментарии

Текстовое представление value создается путем вызова метода Int32.ToString.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

public static void WriteLine (decimal value);

Параметры

Исключения

Примеры

В следующем примере приведен калькулятор чаевых, который вычисляет 18% подсказки и использует метод WriteLine для отображения суммы исходной платы, суммы чаевых и суммы. Примером является консольное приложение, которое требует от пользователя предоставить сумму исходной платы в качестве параметра командной строки.

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

Комментарии

Текстовое представление value создается путем вызова метода Decimal.ToString.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

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

public static void WriteLine (char[] buffer);

Параметры

Исключения

Комментарии

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

public static void WriteLine (char value);

Параметры

Исключения

Примеры

В следующем примере приведен калькулятор чаевых, который вычисляет 18% подсказки и использует метод WriteLine для отображения суммы исходной платы, суммы чаевых и суммы. Примером является консольное приложение, которое требует от пользователя предоставить сумму исходной платы в качестве параметра командной строки.

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

Комментарии

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

public static void WriteLine (bool value);

Параметры

Исключения

Примеры

В следующем примере создается десять случайных целых чисел и используется метод Console.WriteLine(Boolean), чтобы указать, являются ли они даже.

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

Комментарии

Текстовое представление value создается путем вызова метода Boolean.ToString.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

public static void WriteLine ();

Исключения

Примеры

В примере изменяется терминатор строки из значения по умолчанию "\r\n" или vbCrLf на "\r\n\r\n" или vbCrLf + vbCrLf. Затем он вызывает методы WriteLine() и WriteLine(String) для отображения выходных данных в консоли.

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.

Комментарии

Терминатор строк по умолчанию — это строка, значение которой является возвращаемым каретки, а затем каналом строки ("\r\n" в C#или vbCrLf в Visual Basic). Можно изменить терминатор строки, задав свойство TextWriter.NewLine свойства Out на другую строку. Пример содержит иллюстрацию.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)
• NewLine
• Out

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

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

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

Параметры

Исключения

Примеры

В следующем примере показаны стандартные описатели форматирования для чисел, дат и перечислений.

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

*/

В следующем примере приведен калькулятор чаевых, который вычисляет 18% подсказки и использует метод WriteLine для отображения суммы исходной платы, суммы чаевых и суммы. Примером является консольное приложение, которое требует от пользователя предоставить сумму исходной платы в качестве параметра командной строки.

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

Комментарии

Этот метод использует функцию составного форматирования .NET, чтобы преобразовать значение объекта в текстовое представление и внедрить это представление в строку. Результирующая строка записывается в выходной поток.

Параметр format состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент форматирования текстовым представлением значения соответствующего объекта.

Синтаксис элемента форматирования — это {индексов[,выравнивание][:formatString] ]}, который задает обязательный индекс, необязательную длину и выравнивание форматированного текста, а также необязательную строку символов описателя формата, которая управляет форматированием соответствующего объекта.

.NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования.

• Дополнительные сведения о функции составного форматирования, поддерживаемой такими методами, как Format, AppendFormatи некоторые перегрузки WriteLine, см. в составных.

• Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.

• Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.

• Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.

• Дополнительные сведения о форматировании см. в типов форматирования.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)
• Типы форматирования в .NET
• составное форматирование

Исходный код:

Console.cs

Исходный код:

Console.cs

Исходный код:

Console.cs

public static void WriteLine (object? value);

public static void WriteLine (object value);

Параметры

Исключения

Примеры

В следующем примере метод WriteLine(Object) используется для отображения каждого значения в массиве объектов в консоли.

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

Комментарии

Если valuenull, записывается только терминатор строки. В противном случае вызывается метод ToStringvalue для создания его строкового представления, а результирующая строка записывается в стандартный выходной поток.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)

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

Параметры

Атрибуты

CLSCompliantAttribute

Исключения

Примеры

В следующем примере показано использование аргументов переменных с методом WriteLine(String, Object, Object, Object, Object). Метод вызывается со строкой составного формата и пятью элементами формата.

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

Комментарии

Этот метод использует функцию составного форматирования .NET, чтобы преобразовать значение объекта в текстовое представление и внедрить это представление в строку. Результирующая строка записывается в выходной поток.

Параметр format состоит из нуля или нескольких запусков текста, пересекающихся с нуля или более индексированных заполнителей, называемых элементами форматирования, которые соответствуют объекту в списке параметров этого метода. Процесс форматирования заменяет каждый элемент форматирования текстовым представлением значения соответствующего объекта.

Синтаксис элемента форматирования — это {индексов[,выравнивание][:formatString] ]}, который задает обязательный индекс, необязательную длину и выравнивание форматированного текста, а также необязательную строку символов описателя формата, которая управляет форматированием соответствующего объекта.

.NET предоставляет обширную поддержку форматирования, которая подробно описана в следующих разделах форматирования.

• Дополнительные сведения о функции составного форматирования, поддерживаемой такими методами, как Format, AppendFormatи некоторые перегрузки WriteLine, см. в составных.

• Дополнительные сведения об описателях числовых форматов см. в строках стандартного числового формата и пользовательских строк числовых форматов.

• Дополнительные сведения о описателях формата даты и времени см. в строках стандартного формата даты и времени и настраиваемых строк формата даты и времени.

• Дополнительные сведения об описателях формата перечисления см. в строках формата перечисления.

• Дополнительные сведения о форматировании см. в типов форматирования.

Дополнительные сведения о концах строки см. в разделе "Примечания" метода WriteLine, который не принимает параметров.

Примечания для тех, кто вызывает этот метод

Этот метод помечается ключевым словом vararg, что означает, что он поддерживает переменное число параметров. Метод можно вызвать из Visual C++, но его нельзя вызвать из кода C# или Visual Basic. Компиляторы C# и Visual Basic разрешают вызовы WriteLine(String, Object, Object, Object, Object) в качестве вызовов WriteLine(String, Object[]).

См. также раздел

• Read()
• ReadLine()
• Write(String, Object)
• Типы форматирования в .NET
• составное форматирование