WebClient.OpenReadAsync Метод

Определение

Пространство имен:

System.Net

Сборки:

netstandard.dll, System.Net.WebClient.dll

Открывает доступный для чтения поток, содержащий указанный ресурс. Эти методы не блокируют вызывающий поток.

Перегрузки

Имя	Описание
OpenReadAsync(Uri)	Открывает доступный для чтения поток, содержащий указанный ресурс. Этот метод не блокирует вызывающий поток.
OpenReadAsync(Uri, Object)	Открывает доступный для чтения поток, содержащий указанный ресурс. Этот метод не блокирует вызывающий поток.

OpenReadAsync(Uri)

Исходный код:

WebClient.cs

Открывает доступный для чтения поток, содержащий указанный ресурс. Этот метод не блокирует вызывающий поток.

public:
 void OpenReadAsync(Uri ^ address);

public void OpenReadAsync(Uri address);

member this.OpenReadAsync : Uri -> unit

Public Sub OpenReadAsync (address As Uri)

Параметры

address

Uri

URI ресурса, который требуется получить.

Исключения

ArgumentNullException

Параметр address имеет значение null.

WebException

URI, сформированный объединением BaseAddress и адресом, является недопустимым.

-или-

Произошла ошибка при скачивании ресурса.

-или-

Произошла ошибка при открытии потока.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

Этот метод извлекает экземпляр, используемый Stream для доступа к ресурсу, указанному параметром address . Поток получается с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Чтобы получить уведомление о доступности потока, добавьте обработчик событий в OpenReadCompleted событие.

Заметка

При завершении Stream.Close работы необходимо вызватьStream, чтобы избежать выхода из системных ресурсов.

Этот метод не блокирует вызывающий поток во время открытия потока. Чтобы заблокировать время ожидания потока, используйте OpenReadAsync этот метод.

В .NET Framework можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.

BaseAddress Если свойство не является пустой строкой ("") и address не указывает абсолютный универсальный код ресурса (URI), должен быть относительным URI, address объединенным с BaseAddress формой абсолютного URI запрошенного ресурса. QueryString Если свойство не nullявляется, оно добавляется в address.

Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.

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

OpenReadAsync(Uri, Object)

Исходный код:

WebClient.cs

Открывает доступный для чтения поток, содержащий указанный ресурс. Этот метод не блокирует вызывающий поток.

public:
 void OpenReadAsync(Uri ^ address, System::Object ^ userToken);

public void OpenReadAsync(Uri address, object? userToken);

member this.OpenReadAsync : Uri * obj -> unit

Public Sub OpenReadAsync (address As Uri, userToken As Object)

Параметры

address

Uri

URI ресурса, который требуется получить.

userToken

Object

Определяемый пользователем объект, который передается методу, вызываемого при завершении асинхронной операции.

Исключения

ArgumentNullException

Параметр address имеет значение null.

WebException

URI, сформированный объединением BaseAddress и адресом, является недопустимым.

-или-

Произошла ошибка при скачивании ресурса.

-или-

Произошла ошибка при открытии потока.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

Этот метод извлекает экземпляр, используемый Stream для доступа к ресурсу, указанному параметром address . Поток получается с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Чтобы получить уведомление о доступности потока, добавьте обработчик событий в OpenReadCompleted событие.

Заметка

При завершении Stream.Close работы необходимо вызватьStream, чтобы избежать выхода из системных ресурсов.

Этот метод не блокирует вызывающий поток во время открытия потока. Чтобы заблокировать время ожидания потока, используйте OpenRead этот метод.

В .NET Framework можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.

BaseAddress Если свойство не является пустой строкой ("") и address не указывает абсолютный универсальный код ресурса (URI), должен быть относительным URI, address объединенным с BaseAddress формой абсолютного URI запрошенного ресурса. QueryString Если свойство не nullявляется, оно добавляется в address.

Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.