TextWriter.WriteLine TextWriter.WriteLine TextWriter.WriteLine TextWriter.WriteLine Method

定義

データをテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes data followed by a line terminator to the text string or stream.

オーバーロード

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

Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列と改行をテキスト文字列またはストリームに書き込みます。Writes a formatted string and a new line to the text string or stream, using the same semantics as the Format(String, Object, Object) method.

WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32)

文字の部分配列をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes a subarray of characters followed by a line terminator to the text string or stream.

WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[])

Format(String, Object) と同じセマンティクスを使用して、書式設定された文字列と改行を書き込みます。Writes out a formatted string and a new line, using the same semantics as Format(String, Object).

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

Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列と改行をテキスト文字列またはストリームに書き込みます。Writes a formatted string and a new line to the text string or stream, using the same semantics as the Format(String, Object) method.

WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64)

8 バイト符号なし整数のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of an 8-byte unsigned integer followed by a line terminator to the text string or stream.

WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32)

4 バイト符号なし整数のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of a 4-byte unsigned integer followed by a line terminator to the text string or stream.

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

Format(String, Object) と同じセマンティクスを使用して、書式設定された文字列と改行を書き込みます。Writes out a formatted string and a new line, using the same semantics as Format(String, Object).

WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder)
WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

文字列をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes a string followed by a line terminator to the text string or stream.

WriteLine(Single) WriteLine(Single) WriteLine(Single) WriteLine(Single)

4 バイト浮動小数点値のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of a 4-byte floating-point value followed by a line terminator to the text string or stream.

WriteLine(Double) WriteLine(Double) WriteLine(Double) WriteLine(Double)

8 バイト浮動小数点値のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of a 8-byte floating-point value followed by a line terminator to the text string or stream.

WriteLine(Object) WriteLine(Object) WriteLine(Object) WriteLine(Object)

オブジェクトで ToString メソッドを呼び出して、そのオブジェクトのテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of an object by calling the ToString method on that object, followed by a line terminator to the text string or stream.

WriteLine(Int64) WriteLine(Int64) WriteLine(Int64) WriteLine(Int64)

8 バイト符号付き整数のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of an 8-byte signed integer followed by a line terminator to the text string or stream.

WriteLine(Int32) WriteLine(Int32) WriteLine(Int32) WriteLine(Int32)

4 バイト符号付き整数のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of a 4-byte signed integer followed by a line terminator to the text string or stream.

WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal)

10 進値のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of a decimal value followed by a line terminator to the text string or stream.

WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[])

文字の配列をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes an array of characters followed by a line terminator to the text string or stream.

WriteLine(Char) WriteLine(Char) WriteLine(Char) WriteLine(Char)

文字をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes a character followed by a line terminator to the text string or stream.

WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean)

Boolean 値のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of a Boolean value followed by a line terminator to the text string or stream.

WriteLine() WriteLine() WriteLine() WriteLine()

行終端記号をテキスト文字列またはストリームに書き込みます。Writes a line terminator to the text string or stream.

WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>)

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

Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列と改行をテキスト文字列またはストリームに書き込みます。Writes a formatted string and a new line to the text string or stream, using the same semantics as the Format(String, Object, Object) method.

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void WriteLine (string format, object arg0, object arg1);
abstract member WriteLine : string * obj * obj -> unit
override this.WriteLine : string * obj * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object, arg1 As Object)

パラメーター

format
String String String String

複合書式設定文字列。A composite format string.

arg0
Object Object Object Object

書式設定および書き込みをする最初のオブジェクト。The first object to format and write.

arg1
Object Object Object Object

書式設定および書き込みをする 2 番目のオブジェクト。The second object to format and write.

例外

I/O エラーが発生します。An I/O error occurs.

format は有効な復号書式指定文字列ではありません。format is not a valid composite format string.

または-or- 書式指定項目のインデックスが、0 (ゼロ) より小さいか、書式設定されるオブジェクトの数 (このメソッド オーバーロードでは 2) 以上です。The index of a format item is less than 0 (zero), or greater than or equal to the number of objects to be formatted (which, for this method overload, is two).

注釈

このメソッドは、オブジェクトの値を文字列表現に変換して、その表現を文字列に埋め込むには、複合書式指定を使用します。This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET には、次の書式設定のトピックで詳しく説明されている広範な書式設定のサポートが用意されています。.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

formatパラメーターは、0 または 0 個以上のインデックス付きプレース ホルダーをこのメソッドのパラメーター リスト内のオブジェクトに対応する書式指定項目と呼ばれる個以上のテキストが混在します。The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. 書式設定プロセスでは、対応するオブジェクトの値の文字列表現を各書式項目が置き換えられます。The formatting process replaces each format item with the string representation of the value of the corresponding object.

書式指定項目の構文は次のとおりです。The syntax of a format item is as follows:

{index[,length][:formatString]}{index[,length][:formatString]}

角かっこ内の要素は省略可能です。Elements in square brackets are optional. 次の表は、それぞれの要素の説明です。The following table describes each element. 複合書式指定項目の構文を含む、機能を書式設定の詳細については、次を参照してください。複合書式指定します。For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

要素Element 説明Description
インデックスindex 書式設定するオブジェクトのパラメーター リスト内の 0 から始まる位置。The zero-based position in the parameter list of the object to be formatted. オブジェクトを指定して場合インデックスnull、書式指定項目が置き換えString.EmptyIf the object specified by index is null, the format item is replaced by String.Empty. このオーバー ロードは、パラメーターで 2 つのオブジェクトを持つための値の一覧のインデックス0 または 1 を常にある必要があります。Because this overload has two objects in its parameter list, the value of index must always be 0 or 1. 内のパラメーターがない場合、インデックス、位置、FormatExceptionがスローされます。If there is no parameter in the index position, a FormatException is thrown.
長さ,length パラメーターの文字列表記で文字の最小数。The minimum number of characters in the string representation of the parameter. パラメーターでは、右揃え、正の場合負の場合は、左揃えをお勧めします。If positive, the parameter is right-aligned; if negative, it is left-aligned.
:formatString:formatString 書式設定するオブジェクトでサポートされている標準またはカスタム書式指定文字列。A standard or custom format string that is supported by the object to be formatted. 指定できる値formatStringはオブジェクトのによってサポートされる値と同じToString(string format)メソッド。Possible values for formatString are the same as the values supported by the object's ToString(string format) method. 場合formatStringが指定されていない書式設定するオブジェクトを実装して、IFormattableインターフェイス、nullの値として渡される、formatパラメーターとして使用される、IFormattable.ToString書式指定文字列。If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

先頭と末尾の文字を中かっこ"{"と"}"が必要です。The leading and trailing brace characters, "{" and "}", are required. 単一のリテラル中かっこ文字を指定するformat、先頭の 2 つを指定または末尾の文字は; を中かっこは、"{{"または"}}"。To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

このメソッドは、指定した文字列で個別の改行文字 (16 進数で 0x000a) を検索しないため、改行文字は NewLine に置き換えられません。This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

指定したオブジェクトが書式指定文字列で参照されていない場合は無視されます。If a specified object is not referenced in the format string, it is ignored.

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32) WriteLine(Char[], Int32, Int32)

文字の部分配列をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes a subarray of characters followed by a line terminator to the text string or stream.

public:
 virtual void WriteLine(cli::array <char> ^ buffer, int index, int count);
public virtual void WriteLine (char[] buffer, int index, int count);
abstract member WriteLine : char[] * int * int -> unit
override this.WriteLine : char[] * int * int -> unit
Public Overridable Sub WriteLine (buffer As Char(), index As Integer, count As Integer)

パラメーター

buffer
Char[]

データの読み取り元の文字配列。The character array from which data is read.

index
Int32 Int32 Int32 Int32

データの読み込みを開始する、buffer 内の文字の位置。The character position in buffer at which to start reading data.

count
Int32 Int32 Int32 Int32

書き込む文字の最大数。The maximum number of characters to write.

例外

バッファーの長さから index を引いた値が count 未満です。The buffer length minus index is less than count.

buffer パラメーターが null です。The buffer parameter is null.

index または count が負の値です。index or count is negative.

I/O エラーが発生します。An I/O error occurs.

注釈

このメソッドは書き込みcount文字のデータにこのTextWriterから、buffer位置から文字配列indexします。This method will write count characters of data into this TextWriter from the buffer character array starting at position index.

このオーバー ロードの呼び出しと同じですが、Write(Char[])メソッドに続けてWriteLine内の各文字のbufferindexと (index + count)。This overload is equivalent to calling the Write(Char[]) method followed by WriteLine for each character in buffer between index and (index + count).

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[])

Format(String, Object) と同じセマンティクスを使用して、書式設定された文字列と改行を書き込みます。Writes out a formatted string and a new line, using the same semantics as Format(String, Object).

public:
 virtual void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void WriteLine (string format, params object[] arg);
abstract member WriteLine : string * obj[] -> unit
override this.WriteLine : string * obj[] -> unit
Public Overridable Sub WriteLine (format As String, ParamArray arg As Object())

パラメーター

format
String String String String

複合書式設定文字列。A composite format string.

arg
Object[]

書式設定および書き込みをする 0 個以上のオブジェクトを含むオブジェクト配列。An object array that contains zero or more objects to format and write.

例外

文字列またはオブジェクトが null として渡されました。A string or object is passed in as null.

I/O エラーが発生します。An I/O error occurs.

format は有効な復号書式指定文字列ではありません。format is not a valid composite format string.

または-or- 書式項目のインデックスが 0 (ゼロ) 未満であるか、arg 配列の長さ以上です。The index of a format item is less than 0 (zero), or greater than or equal to the length of the arg array.

注釈

このメソッドは、オブジェクトの値を文字列表現に変換して、その表現を文字列に埋め込むには、複合書式指定を使用します。This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET には、次の書式設定のトピックで詳しく説明されている広範な書式設定のサポートが用意されています。.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

formatパラメーターは、0 または 0 個以上のインデックス付きプレース ホルダーをこのメソッドのパラメーター リスト内のオブジェクトに対応する書式指定項目と呼ばれる個以上のテキストが混在します。The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. 書式設定プロセスでは、対応するオブジェクトの値の文字列表現を各書式項目が置き換えられます。The formatting process replaces each format item with the string representation of the value of the corresponding object.

書式指定項目の構文は次のとおりです。The syntax of a format item is as follows:

{index[,length][:formatString]}{index[,length][:formatString]}

角かっこ内の要素は省略可能です。Elements in square brackets are optional. 次の表は、それぞれの要素の説明です。The following table describes each element. 複合書式指定項目の構文を含む、機能を書式設定の詳細については、次を参照してください。複合書式指定します。For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

要素Element 説明Description
インデックスindex 書式設定するオブジェクトのパラメーター リスト内の 0 から始まる位置。The zero-based position in the parameter list of the object to be formatted. オブジェクトを指定して場合インデックスnull、書式指定項目が置き換えString.EmptyIf the object specified by index is null, the format item is replaced by String.Empty. このオーバー ロードが、パラメーター配列があるための値の一覧のインデックス常に、配列の長さより小さくなければなりません。Because this overload has an array in its parameter list, the value of index must always be less than the length of the array. 内のパラメーターがない場合、インデックス、位置、FormatExceptionがスローされます。If there is no parameter in the index position, a FormatException is thrown.
長さ,length パラメーターの文字列表記で文字の最小数。The minimum number of characters in the string representation of the parameter. パラメーターでは、右揃え、正の場合負の場合は、左揃えをお勧めします。If positive, the parameter is right-aligned; if negative, it is left-aligned.
:formatString:formatString 書式設定するオブジェクトでサポートされている標準またはカスタム書式指定文字列。A standard or custom format string that is supported by the object to be formatted. 指定できる値formatStringはオブジェクトのによってサポートされる値と同じToString(string format)メソッド。Possible values for formatString are the same as the values supported by the object's ToString(string format) method. 場合formatStringが指定されていない書式設定するオブジェクトを実装して、IFormattableインターフェイス、nullの値として渡される、formatパラメーターとして使用される、IFormattable.ToString書式指定文字列。If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

先頭と末尾の文字を中かっこ"{"と"}"が必要です。The leading and trailing brace characters, "{" and "}", are required. 単一のリテラル中かっこ文字を指定するformat、先頭の 2 つを指定または末尾の文字は; を中かっこは、"{{"または"}}"。To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

このメソッドは、指定した文字列で個別の改行文字 (16 進数で 0x000a) を検索しないため、改行文字は NewLine に置き換えられません。This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

指定したオブジェクトが書式指定文字列で参照されていない場合は無視されます。If a specified object is not referenced in the format string, it is ignored.

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

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

Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列と改行をテキスト文字列またはストリームに書き込みます。Writes a formatted string and a new line to the text string or stream, using the same semantics as the Format(String, Object) method.

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0);
public virtual void WriteLine (string format, object arg0);
abstract member WriteLine : string * obj -> unit
override this.WriteLine : string * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object)

パラメーター

format
String String String String

複合書式設定文字列。A composite format string.

arg0
Object Object Object Object

書式設定および書き込みをするオブジェクト。The object to format and write.

例外

I/O エラーが発生します。An I/O error occurs.

format は有効な復号書式指定文字列ではありません。format is not a valid composite format string.

または-or- 書式指定項目のインデックスが、0 (ゼロ) より小さいか、書式設定されるオブジェクトの数 (このメソッド オーバーロードでは 1) 以上です。The index of a format item is less than 0 (zero), or greater than or equal to the number of objects to be formatted (which, for this method overload, is one).

注釈

このメソッドは、オブジェクトの値を文字列表現に変換して、その表現を文字列に埋め込むには、複合書式指定を使用します。This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET には、次の書式設定のトピックで詳しく説明されている広範な書式設定のサポートが用意されています。.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

formatパラメーターは、0 または 0 個以上のインデックス付きプレース ホルダーをこのメソッドのパラメーター リスト内のオブジェクトに対応する書式指定項目と呼ばれる個以上のテキストが混在します。The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. 書式設定プロセスでは、対応するオブジェクトの値の文字列表現を各書式項目が置き換えられます。The formatting process replaces each format item with the string representation of the value of the corresponding object.

書式指定項目の構文は次のとおりです。The syntax of a format item is as follows:

{index[,length][:formatString]}{index[,length][:formatString]}

角かっこ内の要素は省略可能です。Elements in square brackets are optional. 次の表は、それぞれの要素の説明です。The following table describes each element. 複合書式指定項目の構文を含む、機能を書式設定の詳細については、次を参照してください。複合書式指定します。For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

要素Element 説明Description
インデックスindex 書式設定するオブジェクトのパラメーター リスト内の 0 から始まる位置。The zero-based position in the parameter list of the object to be formatted. オブジェクトを指定して場合インデックスnull、書式指定項目が置き換えString.EmptyIf the object specified by index is null, the format item is replaced by String.Empty. このオーバー ロードは、パラメーターで 1 つのオブジェクトのみを持つための値の一覧のインデックス常に 0 があります。Because this overload has only a single object in its parameter list, the value of index must always be 0. 内のパラメーターがない場合、インデックス、位置、FormatExceptionがスローされます。If there is no parameter in the index position, a FormatException is thrown.
長さ,length パラメーターの文字列表記で文字の最小数。The minimum number of characters in the string representation of the parameter. パラメーターでは、右揃え、正の場合負の場合は、左揃えをお勧めします。If positive, the parameter is right-aligned; if negative, it is left-aligned.
:formatString:formatString 書式設定するオブジェクトでサポートされている標準またはカスタム書式指定文字列。A standard or custom format string that is supported by the object to be formatted. 指定できる値formatStringはオブジェクトのによってサポートされる値と同じToString(string format)メソッド。Possible values for formatString are the same as the values supported by the object's ToString(string format) method. 場合formatStringが指定されていない書式設定するオブジェクトを実装して、IFormattableインターフェイス、nullの値として渡される、formatパラメーターとして使用される、IFormattable.ToString書式指定文字列。If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

先頭と末尾の文字を中かっこ"{"と"}"が必要です。The leading and trailing brace characters, "{" and "}", are required. 単一のリテラル中かっこ文字を指定するformat、先頭の 2 つを指定または末尾の文字は; を中かっこは、"{{"または"}}"。To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

このメソッドは、指定した文字列で個別の改行文字 (16 進数で 0x000a) を検索しないため、改行文字は NewLine に置き換えられません。This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

指定したオブジェクトが書式指定文字列で参照されていない場合は無視されます。If a specified object is not referenced in the format string, it is ignored.

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64) WriteLine(UInt64)

重要

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

8 バイト符号なし整数のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of an 8-byte unsigned integer followed by a line terminator to the text string or stream.

public:
 virtual void WriteLine(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void WriteLine (ulong value);
abstract member WriteLine : uint64 -> unit
override this.WriteLine : uint64 -> unit
Public Overridable Sub WriteLine (value As ULong)

パラメーター

value
UInt64 UInt64 UInt64 UInt64

書き込む 8 バイト符号なし整数。The 8-byte unsigned integer to write.

例外

I/O エラーが発生します。An I/O error occurs.

注釈

指定した値のテキスト表現が呼び出すことによって生成された、UInt64.ToStringメソッド。The text representation of the specified value is produced by calling the UInt64.ToString method. FormatProviderしない場合は、プロパティnullカルチャに固有の書式を指定します。The FormatProvider property, if not null, specifies the culture-specific formatting.

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32) WriteLine(UInt32)

重要

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

4 バイト符号なし整数のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of a 4-byte unsigned integer followed by a line terminator to the text string or stream.

public:
 virtual void WriteLine(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void WriteLine (uint value);
abstract member WriteLine : uint32 -> unit
override this.WriteLine : uint32 -> unit
Public Overridable Sub WriteLine (value As UInteger)

パラメーター

value
UInt32 UInt32 UInt32 UInt32

書き込む 4 バイト符号なし整数。The 4-byte unsigned integer to write.

例外

I/O エラーが発生します。An I/O error occurs.

注釈

指定した値のテキスト表現が呼び出すことによって生成された、UInt32.ToStringメソッド。The text representation of the specified value is produced by calling the UInt32.ToString method. FormatProviderしない場合は、プロパティnullカルチャに固有の書式を指定します。The FormatProvider property, if not null, specifies the culture-specific formatting.

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

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

Format(String, Object) と同じセマンティクスを使用して、書式設定された文字列と改行を書き込みます。Writes out a formatted string and a new line, using the same semantics as Format(String, Object).

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public virtual void WriteLine (string format, object arg0, object arg1, object arg2);
abstract member WriteLine : string * obj * obj * obj -> unit
override this.WriteLine : string * obj * obj * obj -> unit
Public Overridable Sub WriteLine (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

パラメーター

format
String String String String

複合書式設定文字列。A composite format string.

arg0
Object Object Object Object

書式設定および書き込みをする最初のオブジェクト。The first object to format and write.

arg1
Object Object Object Object

書式設定および書き込みをする 2 番目のオブジェクト。The second object to format and write.

arg2
Object Object Object Object

書式設定および書き込みをする 3 番目のオブジェクト。The third object to format and write.

例外

I/O エラーが発生します。An I/O error occurs.

format は有効な復号書式指定文字列ではありません。format is not a valid composite format string.

または-or- 書式指定項目のインデックスが、0 (ゼロ) より小さいか、書式設定されるオブジェクトの数 (このメソッド オーバーロードでは 3) 以上です。The index of a format item is less than 0 (zero), or greater than or equal to the number of objects to be formatted (which, for this method overload, is three).

注釈

このメソッドは、オブジェクトの値を文字列表現に変換して、その表現を文字列に埋め込むには、複合書式指定を使用します。This method uses composite formatting to convert the value of an object to its string representation and to embed that representation in a string. .NET には、次の書式設定のトピックで詳しく説明されている広範な書式設定のサポートが用意されています。.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

formatパラメーターは、0 または 0 個以上のインデックス付きプレース ホルダーをこのメソッドのパラメーター リスト内のオブジェクトに対応する書式指定項目と呼ばれる個以上のテキストが混在します。The format parameter consists of zero or more runs of text intermixed with zero or more indexed placeholders, called format items, that correspond to an object in the parameter list of this method. 書式設定プロセスでは、対応するオブジェクトの値の文字列表現を各書式項目が置き換えられます。The formatting process replaces each format item with the string representation of the value of the corresponding object.

書式指定項目の構文は次のとおりです。The syntax of a format item is as follows:

{index[,length][:formatString]}{index[,length][:formatString]}

角かっこ内の要素は省略可能です。Elements in square brackets are optional. 次の表は、それぞれの要素の説明です。The following table describes each element. 複合書式指定項目の構文を含む、機能を書式設定の詳細については、次を参照してください。複合書式指定します。For more information about the composite formatting feature, including the syntax of a format item, see Composite Formatting.

要素Element 説明Description
インデックスindex 書式設定するオブジェクトのパラメーター リスト内の 0 から始まる位置。The zero-based position in the parameter list of the object to be formatted. オブジェクトを指定して場合インデックスnull、書式指定項目が置き換えString.EmptyIf the object specified by index is null, the format item is replaced by String.Empty. このオーバー ロードは、パラメーターで 3 つのオブジェクトを持つための値の一覧のインデックス0、1、または 2 を常にある必要があります。Because this overload has three objects in its parameter list, the value of index must always be 0, 1, or 2. 内のパラメーターがない場合、インデックス、位置、FormatExceptionがスローされます。If there is no parameter in the index position, a FormatException is thrown.
長さ,length パラメーターの文字列表記で文字の最小数。The minimum number of characters in the string representation of the parameter. パラメーターでは、右揃え、正の場合負の場合は、左揃えをお勧めします。If positive, the parameter is right-aligned; if negative, it is left-aligned.
:formatString:formatString 書式設定するオブジェクトでサポートされている標準またはカスタム書式指定文字列。A standard or custom format string that is supported by the object to be formatted. 指定できる値formatStringはオブジェクトのによってサポートされる値と同じToString(string format)メソッド。Possible values for formatString are the same as the values supported by the object's ToString(string format) method. 場合formatStringが指定されていない書式設定するオブジェクトを実装して、IFormattableインターフェイス、nullの値として渡される、formatパラメーターとして使用される、IFormattable.ToString書式指定文字列。If formatString is not specified and the object to be formatted implements the IFormattable interface, null is passed as the value of the format parameter that is used as the IFormattable.ToString format string.

先頭と末尾の文字を中かっこ"{"と"}"が必要です。The leading and trailing brace characters, "{" and "}", are required. 単一のリテラル中かっこ文字を指定するformat、先頭の 2 つを指定または末尾の文字は; を中かっこは、"{{"または"}}"。To specify a single literal brace character in format, specify two leading or trailing brace characters; that is, "{{" or "}}".

このメソッドは、指定した文字列で個別の改行文字 (16 進数で 0x000a) を検索しないため、改行文字は NewLine に置き換えられません。This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

指定したオブジェクトが書式指定文字列で参照されていない場合は無視されます。If a specified object is not referenced in the format string, it is ignored.

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder) WriteLine(StringBuilder)

public:
 virtual void WriteLine(System::Text::StringBuilder ^ value);
public virtual void WriteLine (System.Text.StringBuilder value);
abstract member WriteLine : System.Text.StringBuilder -> unit
override this.WriteLine : System.Text.StringBuilder -> unit
Public Overridable Sub WriteLine (value As StringBuilder)

パラメーター

WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

文字列をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes a string followed by a line terminator to the text string or stream.

public:
 virtual void WriteLine(System::String ^ value);
public virtual void WriteLine (string value);
abstract member WriteLine : string -> unit
override this.WriteLine : string -> unit
Public Overridable Sub WriteLine (value As String)

パラメーター

value
String String String String

書き込む文字列。The string to write. valuenull の場合は、行終端記号だけを書き込みます。If value is null, only the line terminator is written.

例外

I/O エラーが発生します。An I/O error occurs.

注釈

このオーバー ロードは、Write(Char[])オーバー ロードします。This overload is equivalent to the Write(Char[]) overload.

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

このメソッドは、指定した文字列で個別の改行文字 (16 進数で 0x000a) を検索しないため、改行文字は NewLine に置き換えられません。This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with NewLine.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

WriteLine(Single) WriteLine(Single) WriteLine(Single) WriteLine(Single)

4 バイト浮動小数点値のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of a 4-byte floating-point value followed by a line terminator to the text string or stream.

public:
 virtual void WriteLine(float value);
public virtual void WriteLine (float value);
abstract member WriteLine : single -> unit
override this.WriteLine : single -> unit
Public Overridable Sub WriteLine (value As Single)

パラメーター

value
Single Single Single Single

書き込む 4 バイト浮動小数点値。The 4-byte floating-point value to write.

例外

I/O エラーが発生します。An I/O error occurs.

注釈

FormatProviderしない場合は、プロパティnullカルチャに固有の書式を指定します。The FormatProvider property, if not null, specifies the culture-specific formatting. 共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

こちらもご覧ください

WriteLine(Double) WriteLine(Double) WriteLine(Double) WriteLine(Double)

8 バイト浮動小数点値のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of a 8-byte floating-point value followed by a line terminator to the text string or stream.

public:
 virtual void WriteLine(double value);
public virtual void WriteLine (double value);
abstract member WriteLine : double -> unit
override this.WriteLine : double -> unit
Public Overridable Sub WriteLine (value As Double)

パラメーター

value
Double Double Double Double

書き込む 8 バイト浮動小数点値。The 8-byte floating-point value to write.

例外

I/O エラーが発生します。An I/O error occurs.

注釈

FormatProviderしない場合は、プロパティnullカルチャに固有の書式を指定します。The FormatProvider property, if not null, specifies the culture-specific formatting. 共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

こちらもご覧ください

WriteLine(Object) WriteLine(Object) WriteLine(Object) WriteLine(Object)

オブジェクトで ToString メソッドを呼び出して、そのオブジェクトのテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of an object by calling the ToString method on that object, followed by a line terminator to the text string or stream.

public:
 virtual void WriteLine(System::Object ^ value);
public virtual void WriteLine (object value);
abstract member WriteLine : obj -> unit
override this.WriteLine : obj -> unit
Public Overridable Sub WriteLine (value As Object)

パラメーター

value
Object Object Object Object

書き込むオブジェクト。The object to write. valuenull の場合は、行終端記号だけを書き込みます。If value is null, only the line terminator is written.

例外

I/O エラーが発生します。An I/O error occurs.

注釈

このオーバー ロードは、Write(String, Object)オーバー ロードします。This overload is equivalent to the Write(String, Object) overload. FormatProviderしない場合は、プロパティnullカルチャに固有の書式を指定します。The FormatProvider property, if not null, specifies the culture-specific formatting.

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

WriteLine(Int64) WriteLine(Int64) WriteLine(Int64) WriteLine(Int64)

8 バイト符号付き整数のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of an 8-byte signed integer followed by a line terminator to the text string or stream.

public:
 virtual void WriteLine(long value);
public virtual void WriteLine (long value);
abstract member WriteLine : int64 -> unit
override this.WriteLine : int64 -> unit
Public Overridable Sub WriteLine (value As Long)

パラメーター

value
Int64 Int64 Int64 Int64

書き込む 8 バイト符号付き整数。The 8-byte signed integer to write.

例外

I/O エラーが発生します。An I/O error occurs.

注釈

指定した値のテキスト表現が呼び出すことによって生成された、Int64.ToStringメソッド。The text representation of the specified value is produced by calling the Int64.ToString method. TextWriter.FormatProviderしない場合は、プロパティnullカルチャに固有の書式を指定します。The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

WriteLine(Int32) WriteLine(Int32) WriteLine(Int32) WriteLine(Int32)

4 バイト符号付き整数のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of a 4-byte signed integer followed by a line terminator to the text string or stream.

public:
 virtual void WriteLine(int value);
public virtual void WriteLine (int value);
abstract member WriteLine : int -> unit
override this.WriteLine : int -> unit
Public Overridable Sub WriteLine (value As Integer)

パラメーター

value
Int32 Int32 Int32 Int32

書き込む 4 バイト符号付き整数。The 4-byte signed integer to write.

例外

I/O エラーが発生します。An I/O error occurs.

注釈

指定した値のテキスト表現が呼び出すことによって生成された、Int32.ToStringメソッド。The text representation of the specified value is produced by calling the Int32.ToString method. TextWriter.FormatProviderしない場合は、プロパティnullカルチャに固有の書式を指定します。The TextWriter.FormatProvider property, if not null, specifies the culture-specific formatting.

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal) WriteLine(Decimal)

10 進値のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of a decimal value followed by a line terminator to the text string or stream.

public:
 virtual void WriteLine(System::Decimal value);
public virtual void WriteLine (decimal value);
abstract member WriteLine : decimal -> unit
override this.WriteLine : decimal -> unit
Public Overridable Sub WriteLine (value As Decimal)

パラメーター

value
Decimal Decimal Decimal Decimal

書き込む 10 進値。The decimal value to write.

例外

I/O エラーが発生します。An I/O error occurs.

注釈

FormatProviderしない場合は、プロパティnullカルチャに固有の書式を指定します。The FormatProvider property, if not null, specifies the culture-specific formatting. 共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

こちらもご覧ください

WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[]) WriteLine(Char[])

文字の配列をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes an array of characters followed by a line terminator to the text string or stream.

public:
 virtual void WriteLine(cli::array <char> ^ buffer);
public virtual void WriteLine (char[] buffer);
abstract member WriteLine : char[] -> unit
override this.WriteLine : char[] -> unit
Public Overridable Sub WriteLine (buffer As Char())

パラメーター

buffer
Char[]

データの読み取り元の文字配列。The character array from which data is read.

例外

I/O エラーが発生します。An I/O error occurs.

注釈

すべての文字bufferは基になるストリームに書き込まれます。All the characters in buffer are written to the underlying stream. 文字配列が null の場合は、行終端記号だけが書き込まれます。If the character array is null, only the line terminator is written.

このオーバー ロードはWrite(Char[])続けてWriteLine()します。This overload is equivalent to Write(Char[]) followed by WriteLine() .

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

WriteLine(Char) WriteLine(Char) WriteLine(Char) WriteLine(Char)

文字をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes a character followed by a line terminator to the text string or stream.

public:
 virtual void WriteLine(char value);
public virtual void WriteLine (char value);
abstract member WriteLine : char -> unit
override this.WriteLine : char -> unit
Public Overridable Sub WriteLine (value As Char)

パラメーター

value
Char Char Char Char

テキスト ストリームに書き込む文字。The character to write to the text stream.

例外

I/O エラーが発生します。An I/O error occurs.

注釈

このオーバー ロードはWrite(Char)続けてWriteLine()します。This overload is equivalent to Write(Char) followed by WriteLine() .

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean) WriteLine(Boolean)

Boolean 値のテキスト形式をテキスト文字列またはストリームに書き込み、続けて行終端記号を書き込みます。Writes the text representation of a Boolean value followed by a line terminator to the text string or stream.

public:
 virtual void WriteLine(bool value);
public virtual void WriteLine (bool value);
abstract member WriteLine : bool -> unit
override this.WriteLine : bool -> unit
Public Overridable Sub WriteLine (value As Boolean)

パラメーター

value
Boolean Boolean Boolean Boolean

書き込む Boolean 値。The Boolean value to write.

例外

I/O エラーが発生します。An I/O error occurs.

注釈

指定した値のテキスト表現が呼び出すことによって生成された、Boolean.ToStringメソッド。The text representation of the specified value is produced by calling the Boolean.ToString method.

このメソッドを出力するかBoolean.TrueStringまたはBoolean.FalseStringします。This method outputs either Boolean.TrueString or Boolean.FalseString.

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

WriteLine() WriteLine() WriteLine() WriteLine()

行終端記号をテキスト文字列またはストリームに書き込みます。Writes a line terminator to the text string or stream.

public:
 virtual void WriteLine();
public virtual void WriteLine ();
abstract member WriteLine : unit -> unit
override this.WriteLine : unit -> unit
Public Overridable Sub WriteLine ()

例外

I/O エラーが発生します。An I/O error occurs.

注釈

行終端記号は、CoreNewLine フィールドで定義されます。The line terminator is defined by the CoreNewLine field.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>) WriteLine(ReadOnlySpan<Char>)

public:
 virtual void WriteLine(ReadOnlySpan<char> buffer);
public virtual void WriteLine (ReadOnlySpan<char> buffer);
abstract member WriteLine : ReadOnlySpan<char> -> unit
override this.WriteLine : ReadOnlySpan<char> -> unit
Public Overridable Sub WriteLine (buffer As ReadOnlySpan(Of Char))

パラメーター

buffer
ReadOnlySpan<Char>

適用対象