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.
