WebClient.OpenReadTaskAsync Метод

Определение

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

System.Net

Сборки:

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

-или-

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

-или-

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

Комментарии

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

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

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

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

Заметка

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

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

-или-

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

-или-

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

Комментарии

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

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

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

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

Заметка

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

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

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

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

Заметка

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

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

• Stream