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, указанный в качестве асинхронной операции с помощью объекта задачи. |
- Исходный код:
- WebClient.cs
- Исходный код:
- 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, содержащий текст ответа, полученный от ресурса при отправке буфера данных.
- Атрибуты
Исключения
Параметр addressnull.
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
Произошла ошибка при открытии потока.
-или-
От сервера, на котором размещен ресурс, не было ответа.
Комментарии
Внимание!
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Эта операция не блокируется. Возвращенный объект Task<TResult> завершится после отправки буфера данных в ресурс.
Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Данные не кодируются.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой (""), а address не содержит абсолютный URI, address должен быть относительным URI, объединенным с BaseAddress для формирования абсолютного URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Примечание
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Применяется к
.NET 10 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- Исходный код:
- WebClient.cs
- Исходный код:
- 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, содержащий текст ответа, полученный от ресурса при отправке буфера данных.
- Атрибуты
Исключения
Параметр addressnull.
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
Произошла ошибка при открытии потока.
-или-
От сервера, на котором размещен ресурс, не было ответа.
Комментарии
Внимание!
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Эта операция не блокируется. Возвращенный объект Task<TResult> завершится после отправки буфера данных в ресурс.
Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Данные не кодируются.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой (""), а address не содержит абсолютный URI, address должен быть относительным URI, объединенным с BaseAddress для формирования абсолютного URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Примечание
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Применяется к
.NET 10 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- Исходный код:
- WebClient.cs
- Исходный код:
- 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, значение по умолчанию — POST для HTTP и STOR для FTP.
- data
- Byte[]
Буфер данных для отправки в ресурс.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает массив Byte, содержащий текст ответа, полученный от ресурса при отправке буфера данных.
- Атрибуты
Исключения
Параметр addressnull.
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
Произошла ошибка при открытии потока.
-или-
От сервера, на котором размещен ресурс, не было ответа.
Комментарии
Внимание!
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Эта операция не блокируется. Возвращенный объект Task<TResult> завершится после отправки буфера данных в ресурс.
Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Данные не кодируются.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой (""), а address не содержит абсолютный URI, address должен быть относительным URI, объединенным с BaseAddress для формирования абсолютного URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Примечание
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Применяется к
.NET 10 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- Исходный код:
- WebClient.cs
- Исходный код:
- 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, значение по умолчанию — POST для HTTP и STOR для FTP.
- data
- Byte[]
Буфер данных для отправки в ресурс.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает массив Byte, содержащий текст ответа, полученный от ресурса при отправке буфера данных.
- Атрибуты
Исключения
Параметр addressnull.
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
Произошла ошибка при открытии потока.
-или-
От сервера, на котором размещен ресурс, не было ответа.
Комментарии
Внимание!
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Эта операция не блокируется. Возвращенный объект Task<TResult> завершится после отправки буфера данных в ресурс.
Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Данные не кодируются.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой (""), а address не содержит абсолютный URI, address должен быть относительным URI, объединенным с BaseAddress для формирования абсолютного URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Примечание
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Применяется к
.NET 10 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
