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


WebClient.DownloadDataTaskAsync Метод

Определение

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

Перегрузки

DownloadDataTaskAsync(String)

Загружает ресурс в виде массива Byte из URI, указанного как асинхронная операция с помощью объекта задачи.

DownloadDataTaskAsync(Uri)

Загружает ресурс в виде массива Byte из URI, указанного как асинхронная операция с помощью объекта задачи.

DownloadDataTaskAsync(String)

Исходный код:
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

Универсальный код ресурса для скачивания.

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

Task<Byte[]>

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

Атрибуты

Исключения

Параметр addressnull.

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

Загружает ресурс в виде массива 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

Универсальный код ресурса для скачивания.

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

Task<Byte[]>

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

Атрибуты

Исключения

Параметр addressnull.

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.

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