WebClient.DownloadDataTaskAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Загружает ресурс в виде Byte массива из URI, указанного как асинхронная операция с помощью объекта задачи. Эти методы не блокируют вызывающий поток.
Перегрузки
| Имя | Описание |
|---|---|
| DownloadDataTaskAsync(String) |
Загружает ресурс в виде Byte массива из URI, указанного как асинхронная операция с помощью объекта задачи. |
| DownloadDataTaskAsync(Uri) |
Загружает ресурс в виде Byte массива из URI, указанного как асинхронная операция с помощью объекта задачи. |
DownloadDataTaskAsync(String)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Загружает ресурс в виде Byte массива из URI, указанного как асинхронная операция с помощью объекта задачи.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(System::String ^ address);public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync(string address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync(string address);member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadDataTaskAsync : string -> System.Threading.Tasks.Task<byte[]>Public Function DownloadDataTaskAsync (address As String) As Task(Of Byte())Параметры
- address
- String
Универсальный код ресурса для скачивания.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает Byte массив, содержащий скачанный ресурс.
- Атрибуты
Исключения
Параметр address имеет значение null.
URI, сформированный BaseAddress объединением и address недопустимым.
-или-
Произошла ошибка при скачивании ресурса.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после скачивания ресурса данных.
Этот метод извлекает указанный ресурс с помощью метода по умолчанию для протокола, связанного со схемой URI, указанной в параметре address . Данные загружаются асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.
BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, address должен быть относительным универсальным кодом ресурса (URI), который объединяется с BaseAddress абсолютным URI запрошенных данных.
QueryString Если свойство не является пустой строкой, она добавляется в address.
Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.
Заметка
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.
В следующем примере кода запрашиваются данные с сервера и отображаются возвращаемые данные. Предполагается, что remoteUri содержит допустимый URI для запрошенных данных.
Применяется к
DownloadDataTaskAsync(Uri)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Загружает ресурс в виде Byte массива из URI, указанного как асинхронная операция с помощью объекта задачи.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ DownloadDataTaskAsync(Uri ^ address);public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync(Uri address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> DownloadDataTaskAsync(Uri address);member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadDataTaskAsync : Uri -> System.Threading.Tasks.Task<byte[]>Public Function DownloadDataTaskAsync (address As Uri) As Task(Of Byte())Параметры
- address
- Uri
Универсальный код ресурса для скачивания.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает Byte массив, содержащий скачанный ресурс.
- Атрибуты
Исключения
Параметр address имеет значение null.
URI, сформированный BaseAddress объединением и address недопустимым.
-или-
Произошла ошибка при скачивании ресурса.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после скачивания ресурса данных.
Этот метод извлекает указанный ресурс с помощью метода по умолчанию для протокола, связанного со схемой URI, указанной в параметре address . Данные загружаются асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.
BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, address должен быть относительным универсальным кодом ресурса (URI), который объединяется с BaseAddress абсолютным URI запрошенных данных.
QueryString Если свойство не является пустой строкой, она добавляется в address.
Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.
Заметка
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.
