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


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[] -> unit
Public 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 -> unit
Public 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[] -> unit
Public 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[]).

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