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, используемый для чтения данных из ресурса.
- Атрибуты
Исключения
Параметр address
null
.
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, используемый для чтения данных из ресурса.
- Атрибуты
Исключения
Параметр address
null
.
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.