WebClient.UploadDataAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отправляет буфер данных в ресурс, определенный URI. Этот метод не блокирует вызывающий поток.
Перегрузки
| UploadDataAsync(Uri, String, Byte[]) |
Отправляет буфер данных в ресурс, определенный URI, с помощью указанного метода. Этот метод не блокирует вызывающий поток. |
| UploadDataAsync(Uri, String, Byte[], Object) |
Отправляет буфер данных в ресурс, определенный URI, с помощью указанного метода и идентификации маркера. |
| UploadDataAsync(Uri, Byte[]) |
Отправляет буфер данных в ресурс, определенный URI, с помощью метода POST. Этот метод не блокирует вызывающий поток. |
UploadDataAsync(Uri, String, Byte[])
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Отправляет буфер данных в ресурс, определенный URI, с помощью указанного метода. Этот метод не блокирует вызывающий поток.
public:
void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);public void UploadDataAsync (Uri address, string? method, byte[] data);public void UploadDataAsync (Uri address, string method, byte[] data);member this.UploadDataAsync : Uri * string * byte[] -> unitPublic Sub UploadDataAsync (address As Uri, method As String, data As Byte())Параметры
- address
- Uri
URI ресурса для получения данных.
- method
- String
Метод, используемый для отправки данных в ресурс. Если null, значение по умолчанию — POST для HTTP и STOR для FTP.
- data
- Byte[]
Буфер данных для отправки в ресурс.
Исключения
Параметр addressnull.
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
Произошла ошибка при открытии потока.
-или-
От сервера, на котором размещен ресурс, не было ответа.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Данные не кодируются. Чтобы получить уведомление после завершения отправки данных, добавьте обработчик событий в событие UploadDataCompleted.
Этот метод не блокирует вызывающий поток во время отправки данных. Для отправки данных и блокировки во время ожидания ответа сервера используйте один из методов UploadData.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой (""), а address не содержит абсолютный URI, address должен быть относительным URI, объединенным с BaseAddress для формирования абсолютного URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Заметка
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых UploadData(Uri, String, Byte[]).
Применяется к
UploadDataAsync(Uri, String, Byte[], Object)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Отправляет буфер данных в ресурс, определенный URI, с помощью указанного метода и идентификации маркера.
public:
void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data, System::Object ^ userToken);public void UploadDataAsync (Uri address, string? method, byte[] data, object? userToken);public void UploadDataAsync (Uri address, string method, byte[] data, object userToken);member this.UploadDataAsync : Uri * string * byte[] * obj -> unitPublic Sub UploadDataAsync (address As Uri, method As String, data As Byte(), userToken As Object)Параметры
- address
- Uri
URI ресурса для получения данных.
- method
- String
Метод, используемый для отправки данных в ресурс. Если null, значение по умолчанию — POST для HTTP и STOR для FTP.
- data
- Byte[]
Буфер данных для отправки в ресурс.
- userToken
- Object
Определяемый пользователем объект, который передается методу, вызываемого при завершении асинхронной операции.
Исключения
Параметр addressnull.
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
Произошла ошибка при открытии потока.
-или-
От сервера, на котором размещен ресурс, не было ответа.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Данные не кодируются. Чтобы получить уведомление после завершения отправки данных, добавьте обработчик событий в событие UploadDataCompleted.
Этот метод не блокирует вызывающий поток во время отправки данных. Для отправки данных и блокировки во время ожидания ответа сервера используйте один из методов UploadData.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой (""), а address не содержит абсолютный URI, address должен быть относительным URI, объединенным с BaseAddress для формирования абсолютного URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Заметка
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Применяется к
UploadDataAsync(Uri, Byte[])
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Отправляет буфер данных в ресурс, определенный URI, с помощью метода POST. Этот метод не блокирует вызывающий поток.
public:
void UploadDataAsync(Uri ^ address, cli::array <System::Byte> ^ data);public void UploadDataAsync (Uri address, byte[] data);member this.UploadDataAsync : Uri * byte[] -> unitPublic Sub UploadDataAsync (address As Uri, data As Byte())Параметры
- address
- Uri
URI ресурса для получения данных.
- data
- Byte[]
Буфер данных для отправки в ресурс.
Исключения
Параметр addressnull.
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
Произошла ошибка при открытии потока.
-или-
От сервера, на котором размещен ресурс, не было ответа.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Этот метод отправляет буфер данных в ресурс. Буфер данных отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Данные не кодируются. Чтобы получить уведомление после завершения отправки данных, добавьте обработчик событий в событие UploadDataCompleted.
Этот метод не блокирует вызывающий поток во время отправки данных. Для отправки данных и блокировки во время ожидания ответа сервера используйте один из методов UploadData.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой (""), а address не содержит абсолютный URI, address должен быть относительным URI, объединенным с BaseAddress для формирования абсолютного URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Заметка
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых UploadData(Uri, Byte[]).
