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
URI загружаемого ресурса.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает массив Byte, содержащий загруженный ресурс.
- Атрибуты
Исключения
Параметр address
имеет значение null
.
URI, образованный объединением BaseAddress и address
, является недопустимым.
-или-
Произошла ошибка при загрузке ресурса.
Комментарии
Эта операция не блокируется. Возвращаемый Task<TResult> объект завершится после загрузки ресурса данных.
Этот метод извлекает указанный ресурс, используя метод по умолчанию для протокола, связанного со схемой URI, указанной в параметре address
. Данные скачиваются асинхронно с помощью ресурсов потока, которые автоматически выделяются из пула потоков.
BaseAddress Если свойство не является пустой строкой ("") и address
не содержит абсолютный URI, то это должен быть относительный URI, address
который объединяется с 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
URI загружаемого ресурса.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает массив Byte, содержащий загруженный ресурс.
- Атрибуты
Исключения
Параметр address
имеет значение null
.
URI, образованный объединением BaseAddress и address
, является недопустимым.
-или-
Произошла ошибка при загрузке ресурса.
Комментарии
Эта операция не блокируется. Возвращаемый Task<TResult> объект завершится после загрузки ресурса данных.
Этот метод извлекает указанный ресурс, используя метод по умолчанию для протокола, связанного со схемой URI, указанной в параметре address
. Данные скачиваются асинхронно с помощью ресурсов потока, которые автоматически выделяются из пула потоков.
BaseAddress Если свойство не является пустой строкой ("") и address
не содержит абсолютный URI, то это должен быть относительный URI, address
который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется к address
.
Этот метод использует команду RETR для скачивания ресурса FTP. Для ресурса HTTP используется метод GET.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в .NET Framework.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по