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

Параметр addressnull.

WebException

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

-или-

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

-или-

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

Комментарии

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

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

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

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

Заметка

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

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

Если свойство BaseAddress не является пустой строкой ("") и address не указывает абсолютный URI, address должен быть относительным URI, объединенным с 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

Параметр addressnull.

WebException

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

-или-

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

-или-

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

Комментарии

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

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

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

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

Заметка

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

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

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

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

Заметка

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

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

• Stream