WebClient.OpenReadAsync Метод

Определение

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

System.Net

Сборка:

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 и адреса, является недопустимым.

-или-

Произошла ошибка при загрузке ресурса.

-или-

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

Комментарии

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

Примечание

Чтобы избежать переполнения системных ресурсов, необходимо вызвать по Stream.Close завершении работы с Stream .

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

В платформа .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не были завершены, вызвав 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 и адреса, является недопустимым.

-или-

Произошла ошибка при загрузке ресурса.

-или-

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

Комментарии

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

Примечание

Чтобы избежать переполнения системных ресурсов, необходимо вызвать по Stream.Close завершении работы с Stream .

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

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

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

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

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.