TextReader.ReadLineAsync メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

オーバーロード

ReadLineAsync()	1 行分の文字を非同期的に読み取り、そのデータを文字列として返します。
ReadLineAsync(CancellationToken)	1 行分の文字を非同期的に読み取り、そのデータを文字列として返します。

ReadLineAsync()

ソース:

TextReader.cs

1 行分の文字を非同期的に読み取り、そのデータを文字列として返します。

public:
 virtual System::Threading::Tasks::Task<System::String ^> ^ ReadLineAsync();

public virtual System.Threading.Tasks.Task<string?> ReadLineAsync ();

abstract member ReadLineAsync : unit -> System.Threading.Tasks.Task<string>
override this.ReadLineAsync : unit -> System.Threading.Tasks.Task<string>

Public Overridable Function ReadLineAsync () As Task(Of String)

戻り値

Task<String>

非同期の読み取り操作を表すタスク。 TResult パラメーターの値には、テキスト リーダーの次の行が含まれます。または、すべての文字が読み取られた場合は null です。

例外

ArgumentOutOfRangeException

次の行の文字数が Int32.MaxValue を超えています。

ObjectDisposedException

テキスト リーダーは破棄されています。

InvalidOperationException

リーダーは、前の読み取り操作によって現在使用されています。

注釈

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

現在 TextReader の が プロパティによって返される標準入力ストリームを Console.In 表す場合、メソッドは ReadLineAsync 非同期ではなく同期的に実行されます。

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

こちらもご覧ください

• ReadLineAsync()
• ReadLineAsync()
• ファイルおよびストリーム入出力
• 方法: ファイルからのテキストの読み取り
• 方法: テキストのファイルへの書き込み

ReadLineAsync(CancellationToken)

ソース:

TextReader.cs

1 行分の文字を非同期的に読み取り、そのデータを文字列として返します。

public:
 virtual System::Threading::Tasks::ValueTask<System::String ^> ReadLineAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.ValueTask<string?> ReadLineAsync (System.Threading.CancellationToken cancellationToken);

abstract member ReadLineAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<string>
override this.ReadLineAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<string>

Public Overridable Function ReadLineAsync (cancellationToken As CancellationToken) As ValueTask(Of String)

パラメーター

cancellationToken

CancellationToken

キャンセル要求を監視するためのトークン。

戻り値

ValueTask<String>

非同期の読み取り操作を表す値タスク。 TResult パラメーターの値には、テキスト リーダーの次の行が含まれます。または、すべての文字が読み取られた場合は null です。

例外

ArgumentOutOfRangeException

次の行の文字数が Int32.MaxValue を超えています。

ObjectDisposedException

テキスト リーダーは破棄されています。

InvalidOperationException

リーダーは、前の読み取り操作によって現在使用されています。

OperationCanceledException

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

注釈

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

現在 TextReader の が プロパティによって返される標準入力ストリームを Console.In 表す場合、メソッドは ReadLineAsync(CancellationToken) 非同期ではなく同期的に実行されます。

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