Поделиться через


WebClient.OpenReadTaskAsync Метод

Определение

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

Перегрузки

OpenReadTaskAsync(String)

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

OpenReadTaskAsync(Uri)

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

OpenReadTaskAsync(String)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (string address);
member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)

Параметры

address
String

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

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

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

Атрибуты

Исключения

Параметр addressnull.

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.

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

Применяется к

OpenReadTaskAsync(Uri)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (Uri address);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync (Uri address);
member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>
Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)

Параметры

address
Uri

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

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

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

Атрибуты

Исключения

Параметр addressnull.

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.

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

Применяется к