Поделиться через


TextReader.ReadLineAsync Метод

Определение

Перегрузки

ReadLineAsync()

Асинхронно считывает строку символов и возвращает данные в виде строки.

ReadLineAsync(CancellationToken)

Асинхронно считывает строку символов и возвращает данные в виде строки.

ReadLineAsync()

Исходный код:
TextReader.cs
Исходный код:
TextReader.cs
Исходный код:
TextReader.cs

Асинхронно считывает строку символов и возвращает данные в виде строки.

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

Возвращаемое значение

Задача, представляющая асинхронную операцию чтения. Значение параметра TResult содержит следующую строку из средства чтения текста или значение null, если все символы считаны.

Атрибуты

Исключения

Число символов в следующей строке больше, чем Int32.MaxValue.

Удалено средство чтения текста.

Модуль чтения в настоящее время используется предыдущей операцией чтения.

Комментарии

Класс TextReader представляет собой абстрактный класс. Следовательно, в коде экземпляр этого объекта не создается. Пример использования ReadLineAsync метода см. в StreamReader.ReadLineAsync разделе метод .

Если текущий TextReader представляет стандартный входной поток, возвращаемый свойством Console.In , метод выполняется синхронно, ReadLineAsync а не асинхронно.

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые ReadLine().

См. также раздел

Применяется к

ReadLineAsync(CancellationToken)

Исходный код:
TextReader.cs
Исходный код:
TextReader.cs
Исходный код:
TextReader.cs

Асинхронно считывает строку символов и возвращает данные в виде строки.

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

Токен для отслеживания запросов отмены.

Возвращаемое значение

Задача для значения, представляющая асинхронную операцию чтения. Значение параметра TResult содержит следующую строку из средства чтения текста или значение null, если все символы считаны.

Исключения

Число символов в следующей строке больше, чем Int32.MaxValue.

Удалено средство чтения текста.

Модуль чтения в настоящее время используется предыдущей операцией чтения.

Маркер отмены был отменен. Это исключение сохраняется в возвращаемой задаче.

Комментарии

Класс TextReader представляет собой абстрактный класс. Следовательно, в коде экземпляр этого объекта не создается. Пример использования ReadLineAsync(CancellationToken) метода см. в ReadLineAsync(CancellationToken) разделе метод .

Если текущий TextReader представляет стандартный входной поток, возвращаемый свойством Console.In , метод выполняется синхронно, ReadLineAsync(CancellationToken) а не асинхронно.

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые ReadLine().

Применяется к