TextWriter.WriteAsync メソッド

定義

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

オーバーロード

WriteAsync(Char[], Int32, Int32)

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

WriteAsync(StringBuilder, CancellationToken)

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

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

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

WriteAsync(String)

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

WriteAsync(Char[])

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

WriteAsync(Char)

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

WriteAsync(Char[], Int32, Int32)

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

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);
[System.Runtime.InteropServices.ComVisible(false)]
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
[<System.Runtime.InteropServices.ComVisible(false)>]
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

書き込む文字数。

戻り値

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

属性

例外

buffernullです。

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

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

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

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

注釈

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

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

こちらもご覧ください

適用対象

WriteAsync(StringBuilder, CancellationToken)

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

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 です。

戻り値

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

例外

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

注釈

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

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

適用対象

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

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

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 です。

戻り値

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

例外

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

適用対象

WriteAsync(String)

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

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(System::String ^ value);
public virtual System.Threading.Tasks.Task WriteAsync (string value);
public virtual System.Threading.Tasks.Task WriteAsync (string? value);
[System.Runtime.InteropServices.ComVisible(false)]
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
[<System.Runtime.InteropServices.ComVisible(false)>]
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

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

戻り値

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

属性

例外

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

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

注釈

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

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

こちらもご覧ください

適用対象

WriteAsync(Char[])

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

public:
 System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer);
public System.Threading.Tasks.Task WriteAsync (char[] buffer);
public System.Threading.Tasks.Task WriteAsync (char[]? buffer);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task WriteAsync (char[] buffer);
member this.WriteAsync : char[] -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.WriteAsync : char[] -> System.Threading.Tasks.Task
Public Function WriteAsync (buffer As Char()) As Task

パラメーター

buffer
Char[]

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

戻り値

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

属性

例外

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

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

注釈

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

こちらもご覧ください

適用対象

WriteAsync(Char)

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

public:
 virtual System::Threading::Tasks::Task ^ WriteAsync(char value);
public virtual System.Threading.Tasks.Task WriteAsync (char value);
[System.Runtime.InteropServices.ComVisible(false)]
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
[<System.Runtime.InteropServices.ComVisible(false)>]
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

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

戻り値

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

属性

例外

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

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

注釈

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

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

こちらもご覧ください

適用対象