TextWriter.Write TextWriter.Write TextWriter.Write TextWriter.Write Method

定義

データをテキスト文字列またはストリームに書き込みます。Writes data to a text string or stream.

オーバーロード

Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object)

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

Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

文字の部分配列をテキスト文字列またはストリームに書き込みます。Writes a subarray of characters to the text string or stream.

Write(String, Object[]) Write(String, Object[]) Write(String, Object[]) Write(String, Object[])

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

Write(String, Object) Write(String, Object) Write(String, Object) Write(String, Object)

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

Write(UInt64) Write(UInt64) Write(UInt64) Write(UInt64)

8 バイト符号なし整数のテキスト形式をテキスト文字列またはストリームに書き込みます。Writes the text representation of an 8-byte unsigned integer to the text string or stream.

Write(UInt32) Write(UInt32) Write(UInt32) Write(UInt32)

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

Write(StringBuilder) Write(StringBuilder) Write(StringBuilder) Write(StringBuilder)
Write(String) Write(String) Write(String) Write(String)

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

Write(Single) Write(Single) Write(Single) Write(Single)

4 バイト浮動小数点値のテキスト形式をテキスト文字列またはストリームに書き込みます。Writes the text representation of a 4-byte floating-point value to the text string or stream.

Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object)

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

Write(Object) Write(Object) Write(Object) Write(Object)

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

Write(Int64) Write(Int64) Write(Int64) Write(Int64)

8 バイト符号付き整数のテキスト形式をテキスト文字列またはストリームに書き込みます。Writes the text representation of an 8-byte signed integer to the text string or stream.

Write(Int32) Write(Int32) Write(Int32) Write(Int32)

4 バイト符号付き整数のテキスト形式をテキスト文字列またはストリームに書き込みます。Writes the text representation of a 4-byte signed integer to the text string or stream.

Write(Double) Write(Double) Write(Double) Write(Double)

8 バイト浮動小数点値のテキスト形式をテキスト文字列またはストリームに書き込みます。Writes the text representation of an 8-byte floating-point value to the text string or stream.

Write(Decimal) Write(Decimal) Write(Decimal) Write(Decimal)

10 進値のテキスト形式をテキスト文字列またはストリームに書き込みます。Writes the text representation of a decimal value to the text string or stream.

Write(Char[]) Write(Char[]) Write(Char[]) Write(Char[])

文字配列をテキスト文字列またはストリームに書き込みます。Writes a character array to the text string or stream.

Write(Char) Write(Char) Write(Char) Write(Char)

文字をテキスト文字列またはストリームに書き込みます。Writes a character to the text string or stream.

Write(Boolean) Write(Boolean) Write(Boolean) Write(Boolean)

Boolean 値のテキスト形式をテキスト文字列またはストリームに書き込みます。Writes the text representation of a Boolean value to the text string or stream.

Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)

Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object)

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

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void Write (string format, object arg0, object arg1);
abstract member Write : string * obj * obj -> unit
override this.Write : string * obj * obj -> unit
Public Overridable Sub Write (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) を検索しないため、改行文字は TextWriter.NewLine に置き換えられません。This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

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

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

こちらもご覧ください

Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

文字の部分配列をテキスト文字列またはストリームに書き込みます。Writes a subarray of characters to the text string or stream.

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

パラメーター

buffer
Char[]

データの書き込み元の文字配列。The character array to write data from.

index
Int32 Int32 Int32 Int32

データの取得を開始する、バッファー内の文字位置。The character position in the buffer at which to start retrieving data.

count
Int32 Int32 Int32 Int32

書き込む文字数。The 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[])内の各文字のオーバー ロードbufferindexと (index + count)。This overload is equivalent to the Write(Char[]) overload for each character in buffer between index and (index + count).

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

こちらもご覧ください

Write(String, Object[]) Write(String, Object[]) Write(String, Object[]) Write(String, Object[])

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

public:
 virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void Write (string format, params object[] arg);
abstract member Write : string * obj[] -> unit
override this.Write : string * obj[] -> unit
Public Overridable Sub Write (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.

例外

format または argnull です。format or arg is 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) を検索しないため、改行文字は TextWriter.NewLine に置き換えられません。This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

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

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

こちらもご覧ください

Write(String, Object) Write(String, Object) Write(String, Object) Write(String, Object)

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

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0);
public virtual void Write (string format, object arg0);
abstract member Write : string * obj -> unit
override this.Write : string * obj -> unit
Public Overridable Sub Write (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) を検索しないため、改行文字は TextWriter.NewLine に置き換えられません。This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

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

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

こちらもご覧ください

Write(UInt64) Write(UInt64) Write(UInt64) Write(UInt64)

重要

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

8 バイト符号なし整数のテキスト形式をテキスト文字列またはストリームに書き込みます。Writes the text representation of an 8-byte unsigned integer to the text string or stream.

public:
 virtual void Write(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void Write (ulong value);
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit
Public Overridable Sub Write (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. TextWriter.FormatProviderしない場合は、プロパティnullカルチャに固有の書式を指定します。The TextWriter.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.

こちらもご覧ください

Write(UInt32) Write(UInt32) Write(UInt32) Write(UInt32)

重要

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

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

public:
 virtual void Write(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void Write (uint value);
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit
Public Overridable Sub Write (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. TextWriter.FormatProviderしない場合は、プロパティnullカルチャに固有の書式を指定します。The TextWriter.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.

こちらもご覧ください

Write(StringBuilder) Write(StringBuilder) Write(StringBuilder) Write(StringBuilder)

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

パラメーター

Write(String) Write(String) Write(String) Write(String)

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

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

パラメーター

value
String String String String

書き込む文字列。The string to write.

例外

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

注釈

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

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

valuenull の場合は、何もテキスト ストリームに書き込みません。If value is null, nothing is written to the text stream.

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

こちらもご覧ください

Write(Single) Write(Single) Write(Single) Write(Single)

4 バイト浮動小数点値のテキスト形式をテキスト文字列またはストリームに書き込みます。Writes the text representation of a 4-byte floating-point value to the text string or stream.

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

パラメーター

value
Single Single Single Single

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

例外

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

注釈

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

こちらもご覧ください

Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object)

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

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public virtual void Write (string format, object arg0, object arg1, object arg2);
abstract member Write : string * obj * obj * obj -> unit
override this.Write : string * obj * obj * obj -> unit
Public Overridable Sub Write (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) の指定した文字列を検索し、置き換えいないTextWriter.NewLineします。This method does not search the specified string for individual newline characters (hexadecimal 0x000a) and replace them with TextWriter.NewLine.

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

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

こちらもご覧ください

Write(Object) Write(Object) Write(Object) Write(Object)

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

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

パラメーター

value
Object Object Object Object

書き込むオブジェクト。The object to write.

例外

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

注釈

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

指定したオブジェクトが場合null、操作はありませんし、例外はスローされません。If the specified object is null, no action is taken and no exception is thrown. それ以外の場合、オブジェクトのToStringメソッドは、の文字列形式を生成するために呼び出され、結果の文字列が出力ストリームに書き込まれます。Otherwise, the object's ToString method is called to produce the string representation, and the resulting string is then written to the output stream. 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.

こちらもご覧ください

Write(Int64) Write(Int64) Write(Int64) Write(Int64)

8 バイト符号付き整数のテキスト形式をテキスト文字列またはストリームに書き込みます。Writes the text representation of an 8-byte signed integer to the text string or stream.

public:
 virtual void Write(long value);
public virtual void Write (long value);
abstract member Write : int64 -> unit
override this.Write : int64 -> unit
Public Overridable Sub Write (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.

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

方法: ファイルにテキストを書き込むHow to: Write Text to a File

こちらもご覧ください

Write(Int32) Write(Int32) Write(Int32) Write(Int32)

4 バイト符号付き整数のテキスト形式をテキスト文字列またはストリームに書き込みます。Writes the text representation of a 4-byte signed integer to the text string or stream.

public:
 virtual void Write(int value);
public virtual void Write (int value);
abstract member Write : int -> unit
override this.Write : int -> unit
Public Overridable Sub Write (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.

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

こちらもご覧ください

Write(Double) Write(Double) Write(Double) Write(Double)

8 バイト浮動小数点値のテキスト形式をテキスト文字列またはストリームに書き込みます。Writes the text representation of an 8-byte floating-point value to the text string or stream.

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

パラメーター

value
Double Double Double Double

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

例外

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

注釈

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

こちらもご覧ください

Write(Decimal) Write(Decimal) Write(Decimal) Write(Decimal)

10 進値のテキスト形式をテキスト文字列またはストリームに書き込みます。Writes the text representation of a decimal value to the text string or stream.

public:
 virtual void Write(System::Decimal value);
public virtual void Write (decimal value);
abstract member Write : decimal -> unit
override this.Write : decimal -> unit
Public Overridable Sub Write (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.

こちらもご覧ください

Write(Char[]) Write(Char[]) Write(Char[]) Write(Char[])

文字配列をテキスト文字列またはストリームに書き込みます。Writes a character array to the text string or stream.

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

パラメーター

buffer
Char[]

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

例外

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

注釈

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

この既定のメソッドを呼び出す、Write(Char[], Int32, Int32)メソッド全体の文字配列を渡します。This default method calls the Write(Char[], Int32, Int32) method and passes the entire character array. 文字配列がある場合null、何も書き込まれません。If the character array is null, nothing is written.

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

こちらもご覧ください

Write(Char) Write(Char) Write(Char) Write(Char)

文字をテキスト文字列またはストリームに書き込みます。Writes a character to the text string or stream.

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

パラメーター

value
Char Char Char Char

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

例外

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

注釈

この既定のメソッドは、何もしませんが、派生クラスは、適切な機能を提供するメソッドをオーバーライドできます。This default method does nothing, but derived classes can override the method to provide the appropriate functionality.

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

こちらもご覧ください

Write(Boolean) Write(Boolean) Write(Boolean) Write(Boolean)

Boolean 値のテキスト形式をテキスト文字列またはストリームに書き込みます。Writes the text representation of a Boolean value to the text string or stream.

public:
 virtual void Write(bool value);
public virtual void Write (bool value);
abstract member Write : bool -> unit
override this.Write : bool -> unit
Public Overridable Sub Write (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.

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

こちらもご覧ください

Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)

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

パラメーター

buffer
ReadOnlySpan<Char>

適用対象