WebClient.OpenReadTaskAsync Метод

Определение

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

System.Net

Сборка:

System.Net.WebClient.dll

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

Перегрузки

OpenReadTaskAsync(String)	Открывает считываемый поток, содержащий указанный ресурс как асинхронная операция с помощью объекта задачи.
OpenReadTaskAsync(Uri)	Открывает считываемый поток, содержащий указанный ресурс как асинхронная операция с помощью объекта задачи.

OpenReadTaskAsync(String)

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

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (string address);

member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)

Параметры

address

String

URI получаемого ресурса.

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

Task<Stream>

Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает Stream, используемый для считывания данных с ресурса.

Исключения

ArgumentNullException

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

WebException

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

-или-

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

-или-

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

Комментарии

Эта операция не блокируется. Возвращаемый Task<TResult> объект завершится после открытия потока для чтения к ресурсу данных. Этот метод не блокирует вызывающий поток во время открытия потока.

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

Примечание

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

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

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

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

Примечание

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

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

• Stream

OpenReadTaskAsync(Uri)

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

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (Uri address);

member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)

Параметры

address

Uri

URI получаемого ресурса.

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

Task<Stream>

Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает Stream, используемый для считывания данных с ресурса.

Исключения

ArgumentNullException

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

WebException

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

-или-

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

-или-

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

Комментарии

Эта операция не блокируется. Возвращаемый Task<TResult> объект завершится после открытия потока для чтения к ресурсу данных. Этот метод не блокирует вызывающий поток во время открытия потока.

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

Примечание

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

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

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

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

Примечание

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

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

• Stream