TextWriter.Write メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

テキスト ストリームにデータを書き込みます。

オーバーロード

Write(String, Object, Object, Object)	Format(String, Object, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。
Write(Char[], Int32, Int32)	文字のサブ配列をテキスト ストリームに書き込みます。
Write(String, Object[])	Format(String, Object[]) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。
Write(String, Object)	Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。
Write(UInt64)	8 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込みます。
Write(UInt32)	4 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込みます。
Write(StringBuilder)	文字列ビルダーをテキスト ストリームに書き込みます。
Write(String)	文字列をテキスト ストリームに書き込みます。
Write(Single)	4 バイト浮動小数点値のテキスト表現をテキスト ストリームに書き込みます。
Write(String, Object, Object)	Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。
Write(Object)	そのオブジェクトの ToString メソッドを呼び出して、オブジェクトのテキスト表現をテキスト ストリームに書き込みます。
Write(Int64)	8 バイト符号付き整数のテキスト表現をテキスト ストリームに書き込みます。
Write(Int32)	4 バイト符号付き整数のテキスト表現をテキスト ストリームに書き込みます。
Write(Double)	8 バイト浮動小数点値のテキスト表現をテキスト ストリームに書き込みます。
Write(Decimal)	10 進値のテキスト表現をテキスト ストリームに書き込みます。
Write(Char[])	文字配列をテキスト ストリームに書き込みます。
Write(Char)	テキスト ストリームに文字を書き込みます。
Write(Boolean)	Boolean 値のテキスト表現をテキスト ストリームに書き込みます。
Write(ReadOnlySpan<Char>)	テキスト ストリームに文字スパンを書き込みます。

Write(String, Object, Object, Object)

ソース:

TextWriter.cs

Format(String, Object, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。

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

複合書式指定文字列。

arg0

Object

書式設定と書き込みを行う最初のオブジェクト。

arg1

Object

書式設定と書き込みを行う 2 番目のオブジェクト。

arg2

Object

書式設定と書き込みを行う 3 番目のオブジェクト。

例外

ArgumentNullException

format は nullです。

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

FormatException

format は有効な複合書式指定文字列ではありません。

-又は-

書式指定項目のインデックスが 0 (ゼロ) 未満であるか、書式設定するオブジェクトの数以上です (このメソッドのオーバーロードでは 3)。

注釈

このメソッドは、複合書式を使用して、オブジェクトの値を文字列形式に変換し、その表現を文字列に埋め込みます。 .NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。

• 複合書式機能の詳細については、「複合書式」を参照してください。

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

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

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

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

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

書式項目の構文は次のとおりです。

{index[,length][:formatString]}

角かっこ内の要素は省略可能です。 次の表では、各要素について説明します。 書式項目の構文を含む複合書式機能の詳細については、「複合書式を参照してください。

要素	形容
インデックス	書式設定するオブジェクトのパラメーター リスト内の 0 から始まる位置。 インデックス で指定されたオブジェクトが null場合、書式項目は String.Emptyに置き換えられます。 このオーバーロードにはパラメーター リストに 3 つのオブジェクトがあるため、インデックス の値は常に 0、1、または 2 である必要があります。 インデックスの 位置にパラメーターがない場合は、FormatException がスローされます。
、長さ	パラメーターの文字列表現の最小文字数。 正の場合、パラメーターは右揃えになります。負の場合は左揃えになります。
:formatString	書式設定するオブジェクトでサポートされる標準書式指定文字列またはカスタム書式指定文字列。 formatString に指定できる値は、オブジェクトの ToString(string format) メソッドでサポートされている値と同じです。 formatString が指定されておらず、書式設定するオブジェクトが IFormattable インターフェイスを実装している場合、null は、IFormattable.ToString 書式指定文字列として使用される format パラメーターの値として渡されます。

先頭と末尾の中かっこ文字 "{" と "}" が必要です。 formatで 1 つのリテラル中かっこ文字を指定するには、2 つの先頭または末尾の中かっこ文字を指定します。つまり、"{{" または "}}" です。

このメソッドは、指定された文字列で個々の改行文字 (16 進数の0x000a) を検索し、TextWriter.NewLineに置き換えることはありません。

指定したオブジェクトが書式指定文字列で参照されていない場合は無視されます。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• StreamWriter
• StringWriter
• IFormatProvider
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(Char[], Int32, Int32)

ソース:

TextWriter.cs

文字のサブ配列をテキスト ストリームに書き込みます。

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[]

データの書き込み先の文字配列。

index

Int32

データの取得を開始するバッファー内の文字位置。

count

Int32

書き込む文字数。

例外

ArgumentException

バッファーの長さから index を引いた値は、count未満です。

ArgumentNullException

buffer パラメーターは nullです。

ArgumentOutOfRangeException

index または count は負の値です。

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

注釈

このメソッドは、index位置から始まる buffer 文字配列からこの TextWriter にデータの count 文字を書き込みます。

このオーバーロードは、index と (index + count) の間の buffer 内の各文字の Write(Char[]) オーバーロードと同じです。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• Write(Char[], Int32, Int32)
• Write(Char[], Int32, Int32)
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(String, Object[])

ソース:

TextWriter.cs

Format(String, Object[]) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。

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

複合書式指定文字列。

arg

Object[]

書式設定と書き込みを行う 0 個以上のオブジェクトを含むオブジェクト配列。

例外

ArgumentNullException

format または arg が null。

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

FormatException

format は有効な複合書式指定文字列ではありません。

-又は-

書式指定項目のインデックスが 0 (ゼロ) 未満であるか、arg 配列の長さ以上です。

注釈

このメソッドは、複合書式を使用して、オブジェクトの値を文字列形式に変換し、その表現を文字列に埋め込みます。 .NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。

• 複合書式機能の詳細については、「複合書式」を参照してください。

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

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

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

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

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

書式項目の構文は次のとおりです。

{index[,length][:formatString]}

角かっこ内の要素は省略可能です。 次の表では、各要素について説明します。 書式項目の構文を含む複合書式機能の詳細については、「複合書式を参照してください。

要素	形容
インデックス	書式設定するオブジェクトのパラメーター リスト内の 0 から始まる位置。 インデックス で指定されたオブジェクトが null場合、書式項目は String.Emptyに置き換えられます。 このオーバーロードにはパラメーター リストに配列があるため、 インデックスの値は常に配列の長さよりも小さくする必要があります。 インデックスの 位置にパラメーターがない場合は、FormatException がスローされます。
、長さ	パラメーターの文字列表現の最小文字数。 正の場合、パラメーターは右揃えになります。負の場合は左揃えになります。
:formatString	書式設定するオブジェクトでサポートされる標準書式指定文字列またはカスタム書式指定文字列。 formatString に指定できる値は、オブジェクトの ToString(string format) メソッドでサポートされている値と同じです。 formatString が指定されておらず、書式設定するオブジェクトが IFormattable インターフェイスを実装している場合、null は、IFormattable.ToString 書式指定文字列として使用される format パラメーターの値として渡されます。

先頭と末尾の中かっこ文字 "{" と "}" が必要です。 formatで 1 つのリテラル中かっこ文字を指定するには、2 つの先頭または末尾の中かっこ文字を指定します。つまり、"{{" または "}}" です。

このメソッドは、指定された文字列で個々の改行文字 (16 進数の0x000a) を検索し、TextWriter.NewLineに置き換えることはありません。

指定したオブジェクトが書式指定文字列で参照されていない場合は無視されます。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• StreamWriter
• StringWriter
• IFormatProvider
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(String, Object)

ソース:

TextWriter.cs

Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。

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

複合書式指定文字列。

arg0

Object

書式設定および書き込み対象のオブジェクト。

例外

ArgumentNullException

format は nullです。

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

FormatException

format は有効な複合書式指定文字列ではありません。

-又は-

書式指定項目のインデックスが 0 (ゼロ) 未満であるか、書式設定するオブジェクトの数以上です (このメソッドのオーバーロードでは 1)。

注釈

このメソッドは、複合書式を使用して、オブジェクトの値を文字列形式に変換し、その表現を文字列に埋め込みます。 .NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。

• 複合書式機能の詳細については、「複合書式」を参照してください。

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

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

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

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

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

書式項目の構文は次のとおりです。

{index[,length][:formatString]}

角かっこ内の要素は省略可能です。 次の表では、各要素について説明します。 書式項目の構文を含む複合書式機能の詳細については、「複合書式を参照してください。

要素	形容
インデックス	書式設定するオブジェクトのパラメーター リスト内の 0 から始まる位置。 インデックス で指定されたオブジェクトが null場合、書式項目は String.Emptyに置き換えられます。 このオーバーロードのパラメーター リストには 1 つのオブジェクトしかないため、インデックス の値は常に 0 である必要があります。 インデックスの 位置にパラメーターがない場合は、FormatException がスローされます。
、長さ	パラメーターの文字列表現の最小文字数。 正の場合、パラメーターは右揃えになります。負の場合は左揃えになります。
:formatString	書式設定するオブジェクトでサポートされる標準書式指定文字列またはカスタム書式指定文字列。 formatString に指定できる値は、オブジェクトの ToString(string format) メソッドでサポートされている値と同じです。 formatString が指定されておらず、書式設定するオブジェクトが IFormattable インターフェイスを実装している場合、null は、IFormattable.ToString 書式指定文字列として使用される format パラメーターの値として渡されます。

先頭と末尾の中かっこ文字 "{" と "}" が必要です。 formatで 1 つのリテラル中かっこ文字を指定するには、2 つの先頭または末尾の中かっこ文字を指定します。つまり、"{{" または "}}" です。

このメソッドは、指定された文字列で個々の改行文字 (16 進数の0x000a) を検索し、TextWriter.NewLineに置き換えることはありません。

指定したオブジェクトが書式指定文字列で参照されていない場合は無視されます。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• StreamWriter
• StringWriter
• IFormatProvider
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(UInt64)

ソース:

TextWriter.cs

重要

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

8 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込みます。

public:
 virtual void Write(System::UInt64 value);

[System.CLSCompliant(false)]
public virtual void Write (ulong value);

[<System.CLSCompliant(false)>]
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit

Public Overridable Sub Write (value As ULong)

パラメーター

value

UInt64

書き込む 8 バイト符号なし整数。

属性

CLSCompliantAttribute

例外

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

注釈

指定した値のテキスト表現は、UInt64.ToString メソッドを呼び出すことによって生成されます。 TextWriter.FormatProvider プロパティは、nullされていない場合は、カルチャ固有の書式を指定します。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• StreamWriter
• StringWriter
• IFormatProvider
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(UInt32)

ソース:

TextWriter.cs

重要

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

4 バイト符号なし整数のテキスト表現をテキスト ストリームに書き込みます。

public:
 virtual void Write(System::UInt32 value);

[System.CLSCompliant(false)]
public virtual void Write (uint value);

[<System.CLSCompliant(false)>]
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit

Public Overridable Sub Write (value As UInteger)

パラメーター

value

UInt32

書き込む 4 バイト符号なし整数。

属性

CLSCompliantAttribute

例外

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

注釈

指定した値のテキスト表現は、UInt32.ToString メソッドを呼び出すことによって生成されます。 TextWriter.FormatProvider プロパティは、nullされていない場合は、カルチャ固有の書式を指定します。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• StreamWriter
• StringWriter
• IFormatProvider
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(StringBuilder)

ソース:

TextWriter.cs

文字列ビルダーをテキスト ストリームに書き込みます。

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

テキスト ストリームに書き込む文字列を、文字列ビルダーとして指定します。

注釈

このメソッドは Write(stringBuilder.ToString())と同じですが、中間文字列の作成を回避するために StringBuilder.GetChunks メソッドを使用します。

Write(String)

ソース:

TextWriter.cs

文字列をテキスト ストリームに書き込みます。

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

書き込む文字列。

例外

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

注釈

このオーバーロードは、Write(Char[]) オーバーロードと同じです。

このメソッドは、指定された文字列で個々の改行文字 (16 進数の0x000a) を検索し、TextWriter.NewLineに置き換えることはありません。

value が nullされている場合、テキスト ストリームには何も書き込まれありません。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• Write(String)
• Write(String)
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(Single)

ソース:

TextWriter.cs

4 バイト浮動小数点値のテキスト表現をテキスト ストリームに書き込みます。

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 バイト浮動小数点値。

例外

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

注釈

指定した値のテキスト表現は、Single.ToString メソッドを呼び出すことによって生成されます。 TextWriter.FormatProvider プロパティは、nullされていない場合は、カルチャ固有の書式を指定します。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• StreamWriter
• StringWriter
• IFormatProvider
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(String, Object, Object)

ソース:

TextWriter.cs

Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をテキスト ストリームに書き込みます。

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

複合書式指定文字列。

arg0

Object

書式設定と書き込みを行う最初のオブジェクト。

arg1

Object

書式設定と書き込みを行う 2 番目のオブジェクト。

例外

ArgumentNullException

format は nullです。

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

FormatException

format は有効な複合書式指定文字列ではありません。

-又は-

書式指定項目のインデックスが 0 (ゼロ) 未満であるか、書式設定するオブジェクトの数以上です (このメソッドのオーバーロードでは 2)。

注釈

このメソッドは、複合書式を使用して、オブジェクトの値を文字列形式に変換し、その表現を文字列に埋め込みます。 .NET では、次の書式設定に関するトピックで詳しく説明されている、広範な書式設定のサポートが提供されています。

• 複合書式機能の詳細については、「複合書式」を参照してください。

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

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

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

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

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

書式項目の構文は次のとおりです。

{index[,length][:formatString]}

角かっこ内の要素は省略可能です。 次の表では、各要素について説明します。 書式項目の構文を含む複合書式機能の詳細については、「複合書式を参照してください。

要素	形容
インデックス	書式設定するオブジェクトのパラメーター リスト内の 0 から始まる位置。 インデックス で指定されたオブジェクトが null場合、書式項目は String.Emptyに置き換えられます。 このオーバーロードにはパラメーター リストに 2 つのオブジェクトがあるため、インデックス の値は常に 0 または 1 である必要があります。 インデックスの 位置にパラメーターがない場合は、FormatException がスローされます。
、長さ	パラメーターの文字列表現の最小文字数。 正の場合、パラメーターは右揃えになります。負の場合は左揃えになります。
:formatString	書式設定するオブジェクトでサポートされる標準書式指定文字列またはカスタム書式指定文字列。 formatString に指定できる値は、オブジェクトの ToString(string format) メソッドでサポートされている値と同じです。 formatString が指定されておらず、書式設定するオブジェクトが IFormattable インターフェイスを実装している場合、null は、IFormattable.ToString 書式指定文字列として使用される format パラメーターの値として渡されます。

先頭と末尾の中かっこ文字 "{" と "}" が必要です。 formatで 1 つのリテラル中かっこ文字を指定するには、2 つの先頭または末尾の中かっこ文字を指定します。つまり、"{{" または "}}" です。

このメソッドは、指定された文字列で個々の改行文字 (16 進数の0x000a) を検索し、TextWriter.NewLineに置き換えることはありません。

指定したオブジェクトが書式指定文字列で参照されていない場合は無視されます。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• StreamWriter
• StringWriter
• IFormatProvider
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(Object)

ソース:

TextWriter.cs

そのオブジェクトの ToString メソッドを呼び出して、オブジェクトのテキスト表現をテキスト ストリームに書き込みます。

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

書き込むオブジェクト。

例外

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

注釈

このオーバーロードは、Write(String) オーバーロードと同じです。

指定したオブジェクトが nullされている場合、アクションは実行されず、例外はスローされません。 それ以外の場合は、オブジェクトの ToString メソッドが呼び出されて文字列表現が生成され、結果の文字列が出力ストリームに書き込まれます。 FormatProvider プロパティは、nullされていない場合は、カルチャ固有の書式を指定します。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• StreamWriter
• StringWriter
• IFormatProvider
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(Int64)

ソース:

TextWriter.cs

8 バイト符号付き整数のテキスト表現をテキスト ストリームに書き込みます。

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 バイト符号付き整数。

例外

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

注釈

指定した値のテキスト表現は、Int64.ToString メソッドを呼び出すことによって生成されます。 TextWriter.FormatProvider プロパティは、nullされていない場合は、カルチャ固有の書式を指定します。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

方法: ファイル にテキストを書き込む

こちらもご覧ください

• StreamWriter
• StringWriter
• IFormatProvider

Write(Int32)

ソース:

TextWriter.cs

4 バイト符号付き整数のテキスト表現をテキスト ストリームに書き込みます。

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 バイト符号付き整数。

例外

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

注釈

指定した値のテキスト表現は、Int32.ToString メソッドを呼び出すことによって生成されます。 TextWriter.FormatProvider プロパティは、nullされていない場合は、カルチャ固有の書式を指定します。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• StreamWriter
• StringWriter
• IFormatProvider
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(Double)

ソース:

TextWriter.cs

8 バイト浮動小数点値のテキスト表現をテキスト ストリームに書き込みます。

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 バイトの浮動小数点値。

例外

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

注釈

指定した値のテキスト表現は、Double.ToString メソッドを呼び出すことによって生成されます。 TextWriter.FormatProvider プロパティは、nullされていない場合は、カルチャ固有の書式を指定します。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• StreamWriter
• StringWriter
• IFormatProvider
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(Decimal)

ソース:

TextWriter.cs

10 進値のテキスト表現をテキスト ストリームに書き込みます。

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 進値。

例外

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

注釈

FormatProvider プロパティは、nullされていない場合は、カルチャ固有の書式を指定します。

こちらもご覧ください

• StreamWriter
• StringWriter
• IFormatProvider
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(Char[])

ソース:

TextWriter.cs

文字配列をテキスト ストリームに書き込みます。

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[]

テキスト ストリームに書き込む文字配列。

例外

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

注釈

このメソッドは、指定された文字列で個々の改行文字 (16 進数の0x000a) を検索し、NewLineに置き換えることはありません。

この既定のメソッドは、Write(Char[], Int32, Int32) メソッドを呼び出し、文字配列全体を渡します。 文字配列が null場合、何も書き込まれありません。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• Write(Char[])
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(Char)

ソース:

TextWriter.cs

テキスト ストリームに文字を書き込みます。

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

テキスト ストリームに書き込む文字。

例外

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

注釈

この既定のメソッドでは何も行われませんが、派生クラスはメソッドをオーバーライドして適切な機能を提供できます。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• Write(Char)
• Write(Char)
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(Boolean)

ソース:

TextWriter.cs

Boolean 値のテキスト表現をテキスト ストリームに書き込みます。

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 値。

例外

ObjectDisposedException

TextWriter は閉じられます。

IOException

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

注釈

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

このメソッドは、Boolean.TrueString または Boolean.FalseStringを出力します。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• StreamWriter
• StringWriter
• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(ReadOnlySpan<Char>)

ソース:

TextWriter.cs

テキスト ストリームに文字スパンを書き込みます。

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>

書き込む文字スパン。

注釈

指定した値のテキスト表現は、ReadOnlySpan<Char>を呼び出すことによって生成されます。ToString メソッド。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。