WebClient.OpenReadAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Открывает доступный для чтения поток, содержащий указанный ресурс. Эти методы не блокируют вызывающий поток.
Перегрузки
| OpenReadAsync(Uri) |
Открывает доступный для чтения поток, содержащий указанный ресурс. Этот метод не блокирует вызывающий поток. |
| OpenReadAsync(Uri, Object) |
Открывает доступный для чтения поток, содержащий указанный ресурс. Этот метод не блокирует вызывающий поток. |
OpenReadAsync(Uri)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Открывает доступный для чтения поток, содержащий указанный ресурс. Этот метод не блокирует вызывающий поток.
public:
void OpenReadAsync(Uri ^ address);public void OpenReadAsync (Uri address);member this.OpenReadAsync : Uri -> unitPublic Sub OpenReadAsync (address As Uri)Параметры
- address
- Uri
URI ресурса, который требуется получить.
Исключения
Параметр addressnull.
URI, сформированный путем объединения BaseAddress и адреса, является недопустимым.
-или-
Произошла ошибка при скачивании ресурса.
-или-
Произошла ошибка при открытии потока.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Этот метод извлекает экземпляр Stream, используемый для доступа к ресурсу, указанному параметром address. Поток получается с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Чтобы получать уведомления о доступности потока, добавьте обработчик событий в событие OpenReadCompleted.
Заметка
При завершении работы с Stream необходимо вызвать Stream.Close, чтобы избежать использования системных ресурсов.
Этот метод не блокирует вызывающий поток во время открытия потока. Чтобы заблокировать время ожидания потока, используйте метод OpenReadAsync.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой ("") и address не указывает абсолютный URI, address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенного ресурса. Если свойство QueryString не null, оно добавляется к address.
Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.
Заметка
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых OpenRead(Uri).
Применяется к
OpenReadAsync(Uri, Object)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Открывает доступный для чтения поток, содержащий указанный ресурс. Этот метод не блокирует вызывающий поток.
public:
void OpenReadAsync(Uri ^ address, System::Object ^ userToken);public void OpenReadAsync (Uri address, object? userToken);public void OpenReadAsync (Uri address, object userToken);member this.OpenReadAsync : Uri * obj -> unitPublic Sub OpenReadAsync (address As Uri, userToken As Object)Параметры
- address
- Uri
URI ресурса, который требуется получить.
- userToken
- Object
Определяемый пользователем объект, который передается методу, вызываемого при завершении асинхронной операции.
Исключения
Параметр addressnull.
URI, сформированный путем объединения BaseAddress и адреса, является недопустимым.
-или-
Произошла ошибка при скачивании ресурса.
-или-
Произошла ошибка при открытии потока.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Этот метод извлекает экземпляр Stream, используемый для доступа к ресурсу, указанному параметром address. Поток получается с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Чтобы получать уведомления о доступности потока, добавьте обработчик событий в событие OpenReadCompleted.
Заметка
При завершении работы с Stream необходимо вызвать Stream.Close, чтобы избежать использования системных ресурсов.
Этот метод не блокирует вызывающий поток во время открытия потока. Чтобы заблокировать время ожидания потока, используйте метод OpenRead.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой ("") и address не указывает абсолютный URI, address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенного ресурса. Если свойство QueryString не null, оно добавляется к address.
Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.
Заметка
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
