Console.WriteLine メソッド

定義

名前空間:

System

アセンブリ:

System.Console.dll

指定したデータを書き込み、その後に現在の行終端記号を標準出力ストリームに書き込みます。

オーバーロード

WriteLine(String, Object, Object)	指定した書式情報を使用して、指定したオブジェクトのテキスト表現を書き込み、その後に現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine(String)	指定した文字列値と現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine(Char[], Int32, Int32)	Unicode 文字の指定されたサブ配列と現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine(String, Object[])	指定した書式情報を使用して、指定したオブジェクト配列のテキスト表現を書き込み、その後に現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine(String, Object)	指定した書式情報を使用して、指定したオブジェクトのテキスト表現を書き込み、その後に現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine(UInt64)	指定した 64 ビット符号なし整数値のテキスト表現と、その後に現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine(UInt32)	指定した 32 ビット符号なし整数値のテキスト表現と、その後に現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine(Single)	指定した単精度浮動小数点値のテキスト表現を標準出力ストリームに書き込み、その後に現在の行終端記号を書き込みます。
WriteLine(Double)	指定した倍精度浮動小数点値のテキスト表現と、その後に現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine(Int64)	指定した 64 ビット符号付き整数値のテキスト表現と、その後に現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine(Int32)	指定した 32 ビット符号付き整数値のテキスト表現と、その後に現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine(Decimal)	指定した Decimal 値のテキスト表現と現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine(Char[])	指定した Unicode 文字の配列と現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine(Char)	指定した Unicode 文字を書き込み、その後に現在の行終端記号の値を標準出力ストリームに書き込みます。
WriteLine(Boolean)	指定したブール値のテキスト表現と現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine()	現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine(String, Object, Object, Object)	指定した書式情報を使用して、指定したオブジェクトのテキスト表現を書き込み、その後に現在の行終端記号を標準出力ストリームに書き込みます。
WriteLine(Object)	指定したオブジェクトのテキスト表現と現在の行終端記号を標準出力ストリームに書き込みます。

注釈

既定の行ターミネータは、値が復帰の後に改行 (C# では "\r\n"、Visual Basic では vbCrLf) が続く文字列です。 行終端記号は、Out プロパティの TextWriter.NewLine プロパティを別の文字列に設定することで変更できます。

WriteLine(String, Object, Object)

ソース:

Console.cs

指定した書式情報を使用して、指定したオブジェクトのテキスト表現を書き込み、その後に現在の行終端記号を標準出力ストリームに書き込みます。

C#

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

パラメーター

format

String

複合書式指定文字列。

arg0

Object

formatを使用して書き込む最初のオブジェクト。

arg1

Object

formatを使用して書き込む 2 番目のオブジェクト。

例外

IOException

I/O エラーが発生しました。

ArgumentNullException

format は nullです。

FormatException

format の書式指定が無効です。

例

次の例では、数値、日付、および列挙型の標準書式指定子を示します。

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

*/

次の例は、18% チップを計算し、WriteLine メソッドを使用して元の料金の金額、チップの金額、合計金額を表示するチップ計算ツールです。 この例は、ユーザーが元の料金の金額をコマンド ライン パラメーターとして指定する必要があるコンソール アプリケーションです。

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

注釈

このメソッドは、.NET の 複合書式設定機能 を使用して、オブジェクトの値をテキスト表現に変換し、その表現を文字列に埋め込みます。 結果の文字列が出力ストリームに書き込まれます。

format パラメーターは、このメソッドのパラメーター リスト内のオブジェクトに対応する、0 個以上のインデックス付きプレースホルダー (書式項目と呼ばれます) が混在する 0 個以上のテキスト実行で構成されます。 書式設定プロセスでは、各書式項目が、対応するオブジェクトの値のテキスト表現に置き換えられます。

書式指定項目の構文 {は、必須のインデックス、書式設定されたテキストの省略可能な長さと配置、および対応するオブジェクトの値の書式設定方法を制御する書式指定文字の省略可能な文字列を指定する、インデックス[,配置][:formatString]}です。

.NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。

• 、、のオーバーロードなどのメソッドでサポートされる複合書式設定機能の詳細については、「複合書式設定参照してください。

• 数値書式指定子の詳細については、「標準の数値書式指定文字列の とカスタム数値書式指定文字列する」を参照してください。

• 日付と時刻の書式指定子の詳細については、「標準の日時書式指定文字列 およびカスタム日時書式指定文字列を参照してください。

• 列挙書式指定子の詳細については、「列挙書式指定文字列の」を参照してください。

• 書式設定の詳細については、「書式設定の種類」を参照してください。

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

• Read()
• ReadLine()
• Write(String, Object)
• .NET の 書式設定の種類
• 複合書式 を する

WriteLine(String)

ソース:

Console.cs

指定した文字列値と現在の行終端記号を標準出力ストリームに書き込みます。

C#

public static void WriteLine (string? value);

パラメーター

value

String

書き込む値。

例外

IOException

I/O エラーが発生しました。

例

この例では、行ターミネータを既定値の "\r\n" または vbCrLf から "\r\n\r\n" または vbCrLf + vbCrLfに変更します。 次に、WriteLine() メソッドと WriteLine(String) メソッドを呼び出して、コンソールに出力を表示します。

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.

注釈

値が nullの場合、ライン ターミネータのみが標準出力ストリームに書き込まれます。

行終端記号の詳細については、WriteLine() メソッドの「解説」セクションを参照してください。

こちらもご覧ください

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

WriteLine(Char[], Int32, Int32)

ソース:

Console.cs

Unicode 文字の指定されたサブ配列と現在の行終端記号を標準出力ストリームに書き込みます。

C#

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

パラメーター

buffer

Char[]

Unicode 文字の配列。

index

Int32

bufferの開始位置。

count

Int32

書き込む文字数。

例外

ArgumentNullException

buffer は nullです。

ArgumentOutOfRangeException

index または count が 0 未満です。

ArgumentException

index プラス countbuffer内にない位置を指定します。

IOException

I/O エラーが発生しました。

注釈

このメソッドは、buffer の位置 index から始まる count 文字を標準出力ストリームに書き込みます。

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

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

WriteLine(String, Object[])

ソース:

Console.cs

指定した書式情報を使用して、指定したオブジェクト配列のテキスト表現を書き込み、その後に現在の行終端記号を標準出力ストリームに書き込みます。

C#

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

パラメーター

format

String

複合書式指定文字列。

arg

Object[]

formatを使用して書き込むオブジェクトの配列。

例外

IOException

I/O エラーが発生しました。

ArgumentNullException

format または arg が null。

FormatException

format の書式指定が無効です。

例

次の例では、数値、日付、および列挙型の標準書式指定子を示します。

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

*/

次の例は、18% チップを計算し、WriteLine メソッドを使用して元の料金の金額、チップの金額、合計金額を表示するチップ計算ツールです。 この例は、ユーザーが元の料金の金額をコマンド ライン パラメーターとして指定する必要があるコンソール アプリケーションです。

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

注釈

このメソッドは、.NET の 複合書式設定機能 を使用して、オブジェクトの値をテキスト表現に変換し、その表現を文字列に埋め込みます。 結果の文字列が出力ストリームに書き込まれます。

format パラメーターは、このメソッドのパラメーター リスト内のオブジェクトに対応する、0 個以上のインデックス付きプレースホルダー (書式項目と呼ばれます) が混在する 0 個以上のテキスト実行で構成されます。 書式設定プロセスでは、各書式項目が、対応するオブジェクトの値のテキスト表現に置き換えられます。

書式指定項目の構文 {は、必須のインデックス、書式設定されたテキストの省略可能な長さと配置、および対応するオブジェクトの値の書式設定方法を制御する書式指定文字の省略可能な文字列を指定する、インデックス[,配置][:formatString]}です。

.NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。

• 、、のオーバーロードなどのメソッドでサポートされる複合書式設定機能の詳細については、「複合書式設定参照してください。

• 数値書式指定子の詳細については、「標準の数値書式指定文字列の とカスタム数値書式指定文字列する」を参照してください。

• 日付と時刻の書式指定子の詳細については、「標準の日時書式指定文字列 およびカスタム日時書式指定文字列を参照してください。

• 列挙書式指定子の詳細については、「列挙書式指定文字列の」を参照してください。

• 書式設定の詳細については、「書式設定の種類」を参照してください。

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

注意 (呼び出し元)

このメソッドは C++ コードでは呼び出されません。 C++ コンパイラは、の呼び出しとして文字列と 4 つ以上のオブジェクト パラメーターのリストを含む System.Console.WriteLine の呼び出しを解決します。 これは、WriteLine(String, Object)の呼び出しとして文字列とオブジェクト配列を含む System.Console.WriteLine の呼び出しを解決します。

こちらもご覧ください

• Read()
• ReadLine()
• Write(String, Object)
• .NET の 書式設定の種類
• 複合書式 を する

WriteLine(String, Object)

ソース:

Console.cs

指定した書式情報を使用して、指定したオブジェクトのテキスト表現を書き込み、その後に現在の行終端記号を標準出力ストリームに書き込みます。

C#

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

パラメーター

format

String

複合書式指定文字列。

arg0

Object

formatを使用して書き込むオブジェクト。

例外

IOException

I/O エラーが発生しました。

ArgumentNullException

format は nullです。

FormatException

format の書式指定が無効です。

例

次の例では、WriteLine(String, Object) メソッドを呼び出して、ランダムに生成された 5 つの Boolean 値を表示します。

C#

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

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

次の例では、WriteLine(String, Object) メソッドを呼び出して現在の日付を表示します。 format 引数の書式指定項目は、標準の日時書式指定文字列 "D" を使用して、現在のカルチャの長い日付形式で日付を表示 ことに注意してください。

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

注釈

このメソッドは、.NET の 複合書式設定機能 を使用して、オブジェクトの値をテキスト表現に変換し、その表現を文字列に埋め込みます。 結果の文字列が出力ストリームに書き込まれます。

format パラメーターは、このメソッドのパラメーター リスト内のオブジェクトに対応する、0 個以上のインデックス付きプレースホルダー (書式項目と呼ばれます) が混在する 0 個以上のテキスト実行で構成されます。 書式設定プロセスでは、各書式項目が、対応するオブジェクトの値のテキスト表現に置き換えられます。

書式指定項目の構文 {は、必須のインデックス、書式設定されたテキストの省略可能な長さと配置、および対応するオブジェクトの値の書式設定方法を制御する書式指定文字の省略可能な文字列を指定する、インデックス[,配置][:formatString]}です。

.NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。

• 、、のオーバーロードなどのメソッドでサポートされる複合書式設定機能の詳細については、「複合書式設定参照してください。

• 数値書式指定子の詳細については、「標準の数値書式指定文字列の とカスタム数値書式指定文字列する」を参照してください。

• 日付と時刻の書式指定子の詳細については、「標準の日時書式指定文字列 およびカスタム日時書式指定文字列を参照してください。

• 列挙書式指定子の詳細については、「列挙書式指定文字列の」を参照してください。

• 書式設定の詳細については、「書式設定の種類」を参照してください。

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

• Read()
• ReadLine()
• Write(String, Object)
• .NET の 書式設定の種類
• 複合書式 を する

WriteLine(UInt64)

ソース:

Console.cs

重要

この API は CLS 準拠ではありません。

指定した 64 ビット符号なし整数値のテキスト表現と、その後に現在の行終端記号を標準出力ストリームに書き込みます。

C#

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

パラメーター

value

UInt64

書き込む値。

属性

CLSCompliantAttribute

例外

IOException

I/O エラーが発生しました。

例

次の例は、18% チップを計算し、WriteLine メソッドを使用して元の料金の金額、チップの金額、合計金額を表示するチップ計算ツールです。 この例は、ユーザーが元の料金の金額をコマンド ライン パラメーターとして指定する必要があるコンソール アプリケーションです。

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

注釈

value のテキスト表現は、UInt64.ToString メソッドを呼び出すことによって生成されます。

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

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

WriteLine(UInt32)

ソース:

Console.cs

重要

この API は CLS 準拠ではありません。

指定した 32 ビット符号なし整数値のテキスト表現と、その後に現在の行終端記号を標準出力ストリームに書き込みます。

C#

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

パラメーター

value

UInt32

書き込む値。

属性

CLSCompliantAttribute

例外

IOException

I/O エラーが発生しました。

例

次の例は、18% チップを計算し、WriteLine メソッドを使用して元の料金の金額、チップの金額、合計金額を表示するチップ計算ツールです。 この例は、ユーザーが元の料金の金額をコマンド ライン パラメーターとして指定する必要があるコンソール アプリケーションです。

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

注釈

value のテキスト表現は、UInt32.ToString メソッドを呼び出すことによって生成されます。

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

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

WriteLine(Single)

ソース:

Console.cs

指定した単精度浮動小数点値のテキスト表現を標準出力ストリームに書き込み、その後に現在の行終端記号を書き込みます。

C#

public static void WriteLine (float value);

パラメーター

value

Single

書き込む値。

例外

IOException

I/O エラーが発生しました。

例

次の例は、18% チップを計算し、WriteLine メソッドを使用して元の料金の金額、チップの金額、合計金額を表示するチップ計算ツールです。 この例は、ユーザーが元の料金の金額をコマンド ライン パラメーターとして指定する必要があるコンソール アプリケーションです。

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

注釈

value のテキスト表現は、Single.ToString メソッドを呼び出すことによって生成されます。

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

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

WriteLine(Double)

ソース:

Console.cs

指定した倍精度浮動小数点値のテキスト表現と、その後に現在の行終端記号を標準出力ストリームに書き込みます。

C#

public static void WriteLine (double value);

パラメーター

value

Double

書き込む値。

例外

IOException

I/O エラーが発生しました。

例

次の例は、18% チップを計算し、WriteLine メソッドを使用して元の料金の金額、チップの金額、合計金額を表示するチップ計算ツールです。 この例は、ユーザーが元の料金の金額をコマンド ライン パラメーターとして指定する必要があるコンソール アプリケーションです。

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

注釈

value のテキスト表現は、Double.ToString メソッドを呼び出すことによって生成されます。

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

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

WriteLine(Int64)

ソース:

Console.cs

指定した 64 ビット符号付き整数値のテキスト表現と、その後に現在の行終端記号を標準出力ストリームに書き込みます。

C#

public static void WriteLine (long value);

パラメーター

value

Int64

書き込む値。

例外

IOException

I/O エラーが発生しました。

例

次の例は、18% チップを計算し、WriteLine メソッドを使用して元の料金の金額、チップの金額、合計金額を表示するチップ計算ツールです。 この例は、ユーザーが元の料金の金額をコマンド ライン パラメーターとして指定する必要があるコンソール アプリケーションです。

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

注釈

value のテキスト表現は、Int64.ToString メソッドを呼び出すことによって生成されます。

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

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

WriteLine(Int32)

ソース:

Console.cs

指定した 32 ビット符号付き整数値のテキスト表現と、その後に現在の行終端記号を標準出力ストリームに書き込みます。

C#

public static void WriteLine (int value);

パラメーター

value

Int32

書き込む値。

例外

IOException

I/O エラーが発生しました。

例

次の例は、18% チップを計算し、WriteLine メソッドを使用して元の料金の金額、チップの金額、合計金額を表示するチップ計算ツールです。 この例は、ユーザーが元の料金の金額をコマンド ライン パラメーターとして指定する必要があるコンソール アプリケーションです。

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

注釈

value のテキスト表現は、Int32.ToString メソッドを呼び出すことによって生成されます。

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

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

WriteLine(Decimal)

ソース:

Console.cs

指定した Decimal 値のテキスト表現と現在の行終端記号を標準出力ストリームに書き込みます。

C#

public static void WriteLine (decimal value);

パラメーター

value

Decimal

書き込む値。

例外

IOException

I/O エラーが発生しました。

例

次の例は、18% チップを計算し、WriteLine メソッドを使用して元の料金の金額、チップの金額、合計金額を表示するチップ計算ツールです。 この例は、ユーザーが元の料金の金額をコマンド ライン パラメーターとして指定する必要があるコンソール アプリケーションです。

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

注釈

value のテキスト表現は、Decimal.ToString メソッドを呼び出すことによって生成されます。

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

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

WriteLine(Char[])

ソース:

Console.cs

指定した Unicode 文字の配列と現在の行終端記号を標準出力ストリームに書き込みます。

C#

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

パラメーター

buffer

Char[]

Unicode 文字配列。

例外

IOException

I/O エラーが発生しました。

注釈

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

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

WriteLine(Char)

ソース:

Console.cs

指定した Unicode 文字を書き込み、その後に現在の行終端記号の値を標準出力ストリームに書き込みます。

C#

public static void WriteLine (char value);

パラメーター

value

Char

書き込む値。

例外

IOException

I/O エラーが発生しました。

例

次の例は、18% チップを計算し、WriteLine メソッドを使用して元の料金の金額、チップの金額、合計金額を表示するチップ計算ツールです。 この例は、ユーザーが元の料金の金額をコマンド ライン パラメーターとして指定する必要があるコンソール アプリケーションです。

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

注釈

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

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

WriteLine(Boolean)

ソース:

Console.cs

指定したブール値のテキスト表現と現在の行終端記号を標準出力ストリームに書き込みます。

C#

public static void WriteLine (bool value);

パラメーター

value

Boolean

書き込む値。

例外

IOException

I/O エラーが発生しました。

例

次の例では、ランダムな整数を 10 個生成し、Console.WriteLine(Boolean) メソッドを使用して偶数かどうかを示します。

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

注釈

value のテキスト表現は、Boolean.ToString メソッドを呼び出すことによって生成されます。

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

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

WriteLine()

ソース:

Console.cs

現在の行終端記号を標準出力ストリームに書き込みます。

C#

public static void WriteLine ();

例外

IOException

I/O エラーが発生しました。

例

この例では、行ターミネータを既定値の "\r\n" または vbCrLf から "\r\n\r\n" または vbCrLf + vbCrLfに変更します。 次に、WriteLine() メソッドと WriteLine(String) メソッドを呼び出して、コンソールに出力を表示します。

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.

注釈

既定の行ターミネータは、値が復帰の後に改行 (C# では "\r\n"、Visual Basic では vbCrLf) が続く文字列です。 行終端記号は、Out プロパティの TextWriter.NewLine プロパティを別の文字列に設定することで変更できます。 この例では、図を示します。

こちらもご覧ください

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

WriteLine(String, Object, Object, Object)

ソース:

Console.cs

指定した書式情報を使用して、指定したオブジェクトのテキスト表現を書き込み、その後に現在の行終端記号を標準出力ストリームに書き込みます。

C#

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

パラメーター

format

String

複合書式指定文字列。

arg0

Object

formatを使用して書き込む最初のオブジェクト。

arg1

Object

formatを使用して書き込む 2 番目のオブジェクト。

arg2

Object

formatを使用して書き込む 3 番目のオブジェクト。

例外

IOException

I/O エラーが発生しました。

ArgumentNullException

format は nullです。

FormatException

format の書式指定が無効です。

例

次の例では、数値、日付、および列挙型の標準書式指定子を示します。

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

*/

次の例は、18% チップを計算し、WriteLine メソッドを使用して元の料金の金額、チップの金額、合計金額を表示するチップ計算ツールです。 この例は、ユーザーが元の料金の金額をコマンド ライン パラメーターとして指定する必要があるコンソール アプリケーションです。

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

注釈

このメソッドは、.NET の 複合書式設定機能 を使用して、オブジェクトの値をテキスト表現に変換し、その表現を文字列に埋め込みます。 結果の文字列が出力ストリームに書き込まれます。

format パラメーターは、このメソッドのパラメーター リスト内のオブジェクトに対応する、0 個以上のインデックス付きプレースホルダー (書式項目と呼ばれます) が混在する 0 個以上のテキスト実行で構成されます。 書式設定プロセスでは、各書式項目が、対応するオブジェクトの値のテキスト表現に置き換えられます。

書式指定項目の構文 {は、必須のインデックス、書式設定されたテキストの省略可能な長さと配置、および対応するオブジェクトの値の書式設定方法を制御する書式指定文字の省略可能な文字列を指定する、インデックス[,配置][:formatString]}です。

.NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。

• 、、のオーバーロードなどのメソッドでサポートされる複合書式設定機能の詳細については、「複合書式設定参照してください。

• 数値書式指定子の詳細については、「標準の数値書式指定文字列の とカスタム数値書式指定文字列する」を参照してください。

• 日付と時刻の書式指定子の詳細については、「標準の日時書式指定文字列 およびカスタム日時書式指定文字列を参照してください。

• 列挙書式指定子の詳細については、「列挙書式指定文字列の」を参照してください。

• 書式設定の詳細については、「書式設定の種類」を参照してください。

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

• Read()
• ReadLine()
• Write(String, Object)
• .NET の 書式設定の種類
• 複合書式 を する

WriteLine(Object)

ソース:

Console.cs

指定したオブジェクトのテキスト表現と現在の行終端記号を標準出力ストリームに書き込みます。

C#

public static void WriteLine (object? value);

パラメーター

value

Object

書き込む値。

例外

IOException

I/O エラーが発生しました。

例

次の例では、WriteLine(Object) メソッドを使用して、オブジェクト配列内の各値をコンソールに表示します。

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

注釈

value が nullの場合は、行ターミネータのみが書き込まれます。 それ以外の場合は、value の ToString メソッドが呼び出されて文字列表現が生成され、結果の文字列が標準出力ストリームに書き込まれます。

行終端記号の詳細については、パラメーターを受け取っていない WriteLine メソッドの「解説」セクションを参照してください。

こちらもご覧ください

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