WebClient.UploadDataTaskAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отправляет буфер данных, содержащий массив Byte на URI, указанного как асинхронная операция с помощью объекта задачи. Эти методы не блокируют вызывающий поток.
Перегрузки
| UploadDataTaskAsync(String, Byte[]) |
Отправляет буфер данных, содержащий массив Byte на URI, указанного как асинхронная операция с помощью объекта задачи. |
| UploadDataTaskAsync(Uri, Byte[]) |
Отправляет буфер данных, содержащий массив Byte на URI, указанного как асинхронная операция с помощью объекта задачи. |
| UploadDataTaskAsync(String, String, Byte[]) |
Отправляет буфер данных, содержащий массив Byte на URI, указанного как асинхронная операция с помощью объекта задачи. |
| UploadDataTaskAsync(Uri, String, Byte[]) |
Отправляет буфер данных, содержащий массив Byte на URI, указанного как асинхронная операция с помощью объекта задачи. |
UploadDataTaskAsync(String, Byte[])
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Отправляет буфер данных, содержащий массив Byte на URI, указанного как асинхронная операция с помощью объекта задачи.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, cli::array <System::Byte> ^ data);public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, byte[] data);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, byte[] data);member this.UploadDataTaskAsync : string * byte[] -> System.Threading.Tasks.Task<byte[]>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadDataTaskAsync : string * byte[] -> System.Threading.Tasks.Task<byte[]>Public Function UploadDataTaskAsync (address As String, data As Byte()) As Task(Of Byte())Параметры
- address
- String
URI ресурса, которому передаются данные.
- data
- Byte[]
Буфер данных, передаваемый ресурсу.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает массив Byte, содержащий тело ответа, полученного из ресурса, когда буфер данных был отправлен.
- Атрибуты
Исключения
Параметр address имеет значение null.
URI, образованный объединением BaseAddress и address, является недопустимым.
-или-
При открытии потока произошла ошибка.
-или-
Сервер, на котором расположен ресурс, не отвечает.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после отправки буфера данных в ресурс.
Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с использованием ресурсов потока, которые автоматически выделяются из пула потоков. Данные не кодируются.
В платформа .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не были завершены, вызвав CancelAsync метод .
BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, должен быть относительным URI, address который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется к address.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.
Применяется к
UploadDataTaskAsync(Uri, Byte[])
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Отправляет буфер данных, содержащий массив Byte на URI, указанного как асинхронная операция с помощью объекта задачи.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, cli::array <System::Byte> ^ data);public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, byte[] data);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, byte[] data);member this.UploadDataTaskAsync : Uri * byte[] -> System.Threading.Tasks.Task<byte[]>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadDataTaskAsync : Uri * byte[] -> System.Threading.Tasks.Task<byte[]>Public Function UploadDataTaskAsync (address As Uri, data As Byte()) As Task(Of Byte())Параметры
- address
- Uri
URI ресурса, которому передаются данные.
- data
- Byte[]
Буфер данных, передаваемый ресурсу.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает массив Byte, содержащий тело ответа, полученного из ресурса, когда буфер данных был отправлен.
- Атрибуты
Исключения
Параметр address имеет значение null.
URI, образованный объединением BaseAddress и address, является недопустимым.
-или-
При открытии потока произошла ошибка.
-или-
Сервер, на котором расположен ресурс, не отвечает.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после отправки буфера данных в ресурс.
Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с использованием ресурсов потока, которые автоматически выделяются из пула потоков. Данные не кодируются.
В платформа .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не были завершены, вызвав CancelAsync метод .
BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, должен быть относительным URI, address который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется к address.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.
Применяется к
UploadDataTaskAsync(String, String, Byte[])
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Отправляет буфер данных, содержащий массив Byte на URI, указанного как асинхронная операция с помощью объекта задачи.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, System::String ^ method, cli::array <System::Byte> ^ data);public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, string? method, byte[] data);public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, string method, byte[] data);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, string method, byte[] data);member this.UploadDataTaskAsync : string * string * byte[] -> System.Threading.Tasks.Task<byte[]>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadDataTaskAsync : string * string * byte[] -> System.Threading.Tasks.Task<byte[]>Public Function UploadDataTaskAsync (address As String, method As String, data As Byte()) As Task(Of Byte())Параметры
- address
- String
URI ресурса, которому передаются данные.
- method
- String
Метод, используемый для передачи данных ресурсу. Если null, для HTTP по умолчанию используется метод POST, а для FTP — STOR.
- data
- Byte[]
Буфер данных, передаваемый ресурсу.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает массив Byte, содержащий тело ответа, полученного из ресурса, когда буфер данных был отправлен.
- Атрибуты
Исключения
Параметр address имеет значение null.
URI, образованный объединением BaseAddress и address, является недопустимым.
-или-
При открытии потока произошла ошибка.
-или-
Сервер, на котором расположен ресурс, не отвечает.
Комментарии
Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после отправки буфера данных в ресурс.
Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с использованием ресурсов потока, которые автоматически выделяются из пула потоков. Данные не кодируются.
В платформа .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не были завершены, вызвав CancelAsync метод .
BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, должен быть относительным URI, address который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется к address.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.
Применяется к
UploadDataTaskAsync(Uri, String, Byte[])
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Отправляет буфер данных, содержащий массив Byte на URI, указанного как асинхронная операция с помощью объекта задачи.
public:
System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, string? method, byte[] data);public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, string method, byte[] data);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, string method, byte[] data);member this.UploadDataTaskAsync : Uri * string * byte[] -> System.Threading.Tasks.Task<byte[]>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadDataTaskAsync : Uri * string * byte[] -> System.Threading.Tasks.Task<byte[]>Public Function UploadDataTaskAsync (address As Uri, method As String, data As Byte()) As Task(Of Byte())Параметры
- address
- Uri
URI ресурса, которому передаются данные.
- method
- String
Метод, используемый для передачи данных ресурсу. Если null, для HTTP по умолчанию используется метод POST, а для FTP — STOR.
- data
- Byte[]
Буфер данных, передаваемый ресурсу.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает массив Byte, содержащий тело ответа, полученного из ресурса, когда буфер данных был отправлен.
- Атрибуты
Исключения
Параметр address имеет значение null.
URI, образованный объединением BaseAddress и address, является недопустимым.
-или-
При открытии потока произошла ошибка.
-или-
Сервер, на котором расположен ресурс, не отвечает.
Комментарии
Эта операция не блокируется. Возвращаемый Task<TResult> объект завершится после отправки буфера данных в ресурс.
Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с использованием ресурсов потока, которые автоматически выделяются из пула потоков. Данные не кодируются.
В платформа .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не были завершены, вызвав CancelAsync метод .
BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, должен быть относительным URI, address который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется к address.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.
Применяется к
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по