TextWriter.WriteAsync メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

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

オーバーロード

WriteAsync(Char[], Int32, Int32)	文字の部分配列をテキスト ストリームに非同期で書き込みます。
WriteAsync(StringBuilder, CancellationToken)	文字列ビルダーをテキスト ストリームに非同期で書き込みます。
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	文字メモリ領域をテキスト ストリームに非同期で書き込みます。
WriteAsync(String)	文字列をテキスト ストリームに非同期で書き込みます。
WriteAsync(Char[])	文字配列をテキスト ストリームに非同期で書き込みます。
WriteAsync(Char)	文字をテキスト ストリームに非同期で書き込みます。

WriteAsync(Char[], Int32, Int32)

ソース:

TextWriter.cs

文字の部分配列をテキスト ストリームに非同期で書き込みます。

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer, int index, int count);

public virtual System.Threading.Tasks.Task WriteAsync (char[] buffer, int index, int count);

abstract member WriteAsync : char[] * int * int -> System.Threading.Tasks.Task
override this.WriteAsync : char[] * int * int -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (buffer As Char(), index As Integer, count As Integer) As Task

パラメーター

buffer

Char[]

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

index

Int32

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

count

Int32

書き込む文字数。

戻り値

Task

非同期の書き込み操作を表すタスク。

例外

ArgumentNullException

buffer が nullです。

ArgumentException

index に count を加算した値がバッファーの長さを超えています。

ArgumentOutOfRangeException

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

ObjectDisposedException

テキスト ライターは破棄されます。

InvalidOperationException

テキスト ライターは現在、前の書き込み操作で使用中です。

注釈

TextWriter クラスは抽象クラスです。 そのため、コードでそれをインスタンス化することはありません。 メソッドの使用 WriteAsync 例については、 メソッドを StreamWriter.WriteAsync 参照してください。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Write(Char[], Int32, Int32)スローされる例外に関するページを参照してください。

こちらもご覧ください

• WriteAsync(Char[], Int32, Int32)
• WriteAsync(Char[], Int32, Int32)

WriteAsync(StringBuilder, CancellationToken)

ソース:

TextWriter.cs

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

public virtual System.Threading.Tasks.Task WriteAsync (System.Text.StringBuilder? value, System.Threading.CancellationToken cancellationToken = default);

abstract member WriteAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As Task

パラメーター

value

StringBuilder

テキスト ストリームに書き込む文字列ビルダーとしての文字列。

cancellationToken

CancellationToken

キャンセル要求を監視するためのトークン。 既定値は None です。

戻り値

Task

非同期の書き込み操作を表すタスク。

例外

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

このメソッドは を呼び出すこと WriteAsync(stringBuilder.ToString())と同じですが、 メソッドを StringBuilder.GetChunks() 使用して中間文字列が作成されないようにします。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Write(StringBuilder)スローされる例外に関するページを参照してください。

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

ソース:

TextWriter.cs

文字メモリ領域をテキスト ストリームに非同期で書き込みます。

public virtual System.Threading.Tasks.Task WriteAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);

abstract member WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (buffer As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As Task

パラメーター

buffer

ReadOnlyMemory<Char>

テキスト ストリームに書き込む文字メモリ領域。

cancellationToken

CancellationToken

キャンセル要求を監視するためのトークン。 既定値は None です。

戻り値

Task

非同期の書き込み操作を表すタスク。

例外

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

WriteAsync(String)

ソース:

TextWriter.cs

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

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(System::String ^ value);

public virtual System.Threading.Tasks.Task WriteAsync (string? value);

abstract member WriteAsync : string -> System.Threading.Tasks.Task
override this.WriteAsync : string -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (value As String) As Task

パラメーター

value

String

書き込む文字列。 value が null の場合は、何もテキスト ストリームに書き込みません。

戻り値

Task

非同期の書き込み操作を表すタスク。

例外

ObjectDisposedException

テキスト ライターは破棄されます。

InvalidOperationException

テキスト ライターは現在、前の書き込み操作で使用中です。

注釈

TextWriter クラスは抽象クラスです。 そのため、コードでそれをインスタンス化することはありません。 メソッドの使用 WriteAsync 例については、 メソッドを StreamWriter.WriteAsync 参照してください。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Write(String)スローされる例外に関するページを参照してください。

こちらもご覧ください

• WriteAsync(String)
• WriteAsync(String)

WriteAsync(Char[])

ソース:

TextWriter.cs

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

public:
 System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer);

public System.Threading.Tasks.Task WriteAsync (char[]? buffer);

member this.WriteAsync : char[] -> System.Threading.Tasks.Task

Public Function WriteAsync (buffer As Char()) As Task

パラメーター

buffer

Char[]

テキスト ストリームに書き込む文字配列。 buffer が null の場合は、何も書き込まれません。

戻り値

Task

非同期の書き込み操作を表すタスク。

例外

ObjectDisposedException

テキスト ライターは破棄されます。

InvalidOperationException

テキスト ライターは現在、前の書き込み操作で使用中です。

注釈

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Write(Char[])スローされる例外に関するページを参照してください。

こちらもご覧ください

• StreamWriter
• StringWriter

WriteAsync(Char)

ソース:

TextWriter.cs

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

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(char value);

public virtual System.Threading.Tasks.Task WriteAsync (char value);

abstract member WriteAsync : char -> System.Threading.Tasks.Task
override this.WriteAsync : char -> System.Threading.Tasks.Task

Public Overridable Function WriteAsync (value As Char) As Task

パラメーター

value

Char

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

戻り値

Task

非同期の書き込み操作を表すタスク。

例外

ObjectDisposedException

テキスト ライターは破棄されます。

InvalidOperationException

テキスト ライターは現在、前の書き込み操作で使用中です。

注釈

TextWriter クラスは抽象クラスです。 そのため、コードでそれをインスタンス化することはありません。 メソッドの使用 WriteAsync 例については、 メソッドを StreamWriter.WriteAsync 参照してください。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Write(Char)スローされる例外に関するページを参照してください。

こちらもご覧ください

• WriteAsync(Char)
• WriteAsync(Char)