TextReader.ReadLineAsync Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
| ReadLineAsync() |
Асинхронно считывает строку символов и возвращает данные в виде строки. |
| ReadLineAsync(CancellationToken) |
Асинхронно считывает строку символов и возвращает данные в виде строки. |
- Исходный код:
- 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()
- ReadLineAsync()
- Файловый и потоковый ввод-вывод
- Практическое руководство. Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Исходный код:
- 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().
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | 7, 8, 9 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: