TextWriter.Write メソッド

定義

テキスト ストリームにデータを書き込みます。Writes data to a text stream.

オーバーロード

Write(String, Object, Object)

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

Write(Char[], Int32, Int32)

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

Write(String, Object[])

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

Write(String, Object)

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

Write(UInt64)

8 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of an 8-byte unsigned integer to the text stream.

Write(UInt32)

4 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a 4-byte unsigned integer to the text stream.

Write(StringBuilder)

文字列ビルダーをテキスト ストリームに書き込みます。Writes a string builder to the text stream.

Write(String)

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

Write(Single)

4 バイト浮動小数点値のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a 4-byte floating-point value to the text stream.

Write(String, Object, Object, Object)

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

Write(Object)

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

Write(Int64)

8 バイト符号付き整数のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of an 8-byte signed integer to the text stream.

Write(Int32)

4 バイト符号付き整数のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a 4-byte signed integer to the text stream.

Write(Double)

8 バイト浮動小数点値のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of an 8-byte floating-point value to the text stream.

Write(Decimal)

10 進値のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a decimal value to the text stream.

Write(Char[])

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

Write(Char)

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

Write(Boolean)

Boolean 値のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a Boolean value to the text stream.

Write(ReadOnlySpan<Char>)

文字スパンをテキスト ストリームに書き込みます。Writes a character span to the text stream.

Write(String, Object, Object)

Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。Writes a formatted string to the text 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

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

arg0
Object

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

arg1
Object

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

例外

formatnullです。format is null.

TextWriter が閉じています。The TextWriter is closed.

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. Indexで指定されたオブジェクトnullがの場合、書式項目はString.Emptyによって置き換えられます。If the object specified by index is null, the format item is replaced by String.Empty. このオーバーロードでは、パラメーターリストに2つのオブジェクトがあるため、 indexの値は常に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,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. で1つのリテラルの中かっこ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)

文字の部分配列をテキスト ストリームに書き込みます。Writes a subarray of characters to the text 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

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

count
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.

TextWriter が閉じています。The TextWriter is closed.

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[]) buffer index index)の間の各文字のオーバーロードに相当します。 + countThis 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[])

Format(String, Object[]) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。Writes a formatted string to the text 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

複合書式設定文字列。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.

TextWriter が閉じています。The TextWriter is closed.

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. Indexで指定されたオブジェクトnullがの場合、書式項目はString.Emptyによって置き換えられます。If 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,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. で1つのリテラルの中かっこ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)

Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。Writes a formatted string to the text 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

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

arg0
Object

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

例外

formatnullです。format is null.

TextWriter が閉じています。The TextWriter is closed.

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. Indexで指定されたオブジェクトnullがの場合、書式項目はString.Emptyによって置き換えられます。If the object specified by index is null, the format item is replaced by String.Empty. このオーバーロードのパラメーターリストにはオブジェクトが1つしかないため、 indexの値は常に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,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. で1つのリテラルの中かっこ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)

重要

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

8 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of an 8-byte unsigned integer to the text 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

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

属性

例外

TextWriter が閉じています。The TextWriter is closed.

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)

重要

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

4 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a 4-byte unsigned integer to the text 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

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

属性

例外

TextWriter が閉じています。The TextWriter is closed.

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)

文字列ビルダーをテキスト ストリームに書き込みます。Writes a string builder to the text stream.

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)

パラメーター

value
StringBuilder

テキスト ストリームに書き込む文字列ビルダーとしての文字列。The string, as a string builder, to write to the text stream.

注釈

このメソッドはと同じWrite(stringBuilder.ToString())ですが、 StringBuilder.GetChunksメソッドを使用して、中間文字列を作成しないようにします。This method is equivalent to Write(stringBuilder.ToString()), but it uses the StringBuilder.GetChunks method to avoid creating the intermediate string.

Write(String)

文字列をテキスト ストリームに書き込みます。Writes a string to the text 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

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

例外

TextWriter が閉じています。The TextWriter is closed.

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)

4 バイト浮動小数点値のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a 4-byte floating-point value to the text 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

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

例外

TextWriter が閉じています。The TextWriter is closed.

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)

Format(String, Object, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。Writes a formatted string to the text 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

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

arg0
Object

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

arg1
Object

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

arg2
Object

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

例外

formatnull です。format is null.

TextWriter が閉じています。The TextWriter is closed.

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. Indexで指定されたオブジェクトnullがの場合、書式項目はString.Emptyによって置き換えられます。If the object specified by index is null, the format item is replaced by String.Empty. このオーバーロードでは、パラメーターリストに3つのオブジェクトがあるため、 indexの値は常に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,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. で1つのリテラルの中かっこ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)

オブジェクトで ToString メソッドを呼び出して、そのオブジェクトのテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of an object to the text 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

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

例外

TextWriter が閉じています。The TextWriter is closed.

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)

8 バイト符号付き整数のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of an 8-byte signed integer to the text 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

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

例外

TextWriter が閉じています。The TextWriter is closed.

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)

4 バイト符号付き整数のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a 4-byte signed integer to the text 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

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

例外

TextWriter が閉じています。The TextWriter is closed.

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)

8 バイト浮動小数点値のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of an 8-byte floating-point value to the text 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

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

例外

TextWriter が閉じています。The TextWriter is closed.

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)

10 進値のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a decimal value to the text 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

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

例外

TextWriter が閉じています。The TextWriter is closed.

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

注釈

プロパティFormatProviderは、カルチャ固有nullの書式を指定します (存在しない場合)。The FormatProvider property, if not null, specifies the culture-specific formatting.

こちらもご覧ください

Write(Char[])

文字配列をテキスト ストリームに書き込みます。Writes a character array to the text 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.

例外

TextWriter が閉じています。The TextWriter is closed.

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)

文字をテキスト ストリームに書き込みます。Writes a character to the text 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

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

例外

TextWriter が閉じています。The TextWriter is closed.

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)

Boolean 値のテキスト表現をテキスト ストリームに書き込みます。Writes the text representation of a Boolean value to the text 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 値。The Boolean value to write.

例外

TextWriter が閉じています。The TextWriter is closed.

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

文字スパンをテキスト ストリームに書き込みます。Writes a character span to the text stream.

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>

書き込む文字スパン。The character span to write.

注釈

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

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

適用対象