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

WebClient.UploadValuesAsync Метод

  • Ссылка

Определение

Пространство имен:
System.Net
Сборка:
System.Net.WebClient.dll
Сборка:
System.dll
Сборка:
netstandard.dll

Отправляет указанную коллекцию имен и значений в ресурс, определенный указанным универсальным кодом ресурса (URI). Эти методы не блокируют вызывающий поток.

Перегрузки

UploadValuesAsync(Uri, NameValueCollection)

Отправляет данные в указанной коллекции имен и значений в ресурс, определенный указанным универсальным кодом ресурса (URI). Этот метод не блокирует вызывающий поток.
UploadValuesAsync(Uri, String, NameValueCollection)

Отправляет данные в указанной коллекции имен и значений в ресурс, определенный указанным универсальным кодом ресурса (URI), с помощью указанного метода. Этот метод не блокирует вызывающий поток.
UploadValuesAsync(Uri, String, NameValueCollection, Object)

Отправляет данные в указанной коллекции имен и значений в ресурс, определенный указанным универсальным кодом ресурса (URI), с помощью указанного метода. Этот метод не блокирует вызывающий поток и позволяет вызывающему объекту передавать объект методу, который вызывается при завершении операции.

UploadValuesAsync(Uri, NameValueCollection)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
WebClient.cs

Отправляет данные в указанной коллекции имен и значений в ресурс, определенный указанным универсальным кодом ресурса (URI). Этот метод не блокирует вызывающий поток.

public:
 void UploadValuesAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public void UploadValuesAsync (Uri address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesAsync : Uri * System.Collections.Specialized.NameValueCollection -> unit
Public Sub UploadValuesAsync (address As Uri, data As NameValueCollection)

Параметры

address
Uri

URI ресурса для получения коллекции. Этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода по умолчанию.

data
NameValueCollection

NameValueCollection для отправки в ресурс.

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр datanull.

WebException

URI, сформированный объединением BaseAddress и address, является недопустимым.

-или-

От сервера, на котором размещен ресурс, не было ответа.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Этот метод отправляет строку в ресурс. Строка отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Перед отправкой строки этот метод преобразует его в массив Byte с помощью кодировки, указанной в свойстве Encoding. Чтобы получить уведомление после завершения отправки строки, можно добавить обработчик событий в событие UploadStringCompleted.

Этот метод не блокирует вызывающий поток во время отправки строки. Чтобы отправить строку и блок во время ожидания ответа сервера, используйте один из методов UploadString.

В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.

Если свойство BaseAddress не является пустой строкой ("") и address не содержит абсолютный универсальный код ресурса (URI), address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.

Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых UploadValues(Uri, NameValueCollection).

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

UploadValuesAsync(Uri, String, NameValueCollection)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
WebClient.cs

Отправляет данные в указанной коллекции имен и значений в ресурс, определенный указанным универсальным кодом ресурса (URI), с помощью указанного метода. Этот метод не блокирует вызывающий поток.

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);
public void UploadValuesAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);
public void UploadValuesAsync (Uri address, string method, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> unit
Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection)

Параметры

address
Uri

URI ресурса для получения коллекции. Этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода method.

method
String

Метод, используемый для отправки строки в ресурс. Если значение NULL, значение по умолчанию — POST для http и STOR для ftp.

data
NameValueCollection

NameValueCollection для отправки в ресурс.

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр datanull.

WebException

URI, сформированный объединением BaseAddress и address, является недопустимым.

-или-

От сервера, на котором размещен ресурс, не было ответа.

-или-

method нельзя использовать для отправки содержимого.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Этот метод отправляет данные, содержащиеся в NameValueCollection, в ресурс address. Используйте этот метод для отправки данных формы в универсальный код ресурса (URI) для обработки. Данные отправляются с помощью типа носителя form-urlencoded; Значение заголовка Content-Type должно иметь значение application/x-www-form-urlencoded. Заголовок задан правильно по умолчанию. Методы UploadValuesAsync вызывают WebException при вызове этого метода с другим значением заголовка Content-Type, заданным в коллекции Headers.

Если метод method не понимается сервером, базовые классы протоколов определяют, что происходит. Как правило, WebException создается со свойством Status, которое указывает на ошибку.

NameValueCollection отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Чтобы получить уведомление после завершения операции отправки, добавьте обработчик событий в событие UploadValuesCompleted.

Этот метод не блокирует вызывающий поток во время отправки строки. Чтобы отправить строку и блок во время ожидания ответа сервера, используйте один из методов UploadValues.

В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.

Если свойство BaseAddress не является пустой строкой ("") и address не содержит абсолютный универсальный код ресурса (URI), address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не является пустым, оно добавляется в address.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в трассировке сети в.NET Framework.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых UploadValues(Uri, String, NameValueCollection).

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

UploadValuesAsync(Uri, String, NameValueCollection, Object)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
WebClient.cs

Отправляет данные в указанной коллекции имен и значений в ресурс, определенный указанным универсальным кодом ресурса (URI), с помощью указанного метода. Этот метод не блокирует вызывающий поток и позволяет вызывающему объекту передавать объект методу, который вызывается при завершении операции.

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data, System::Object ^ userToken);
public void UploadValuesAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data, object? userToken);
public void UploadValuesAsync (Uri address, string method, System.Collections.Specialized.NameValueCollection data, object userToken);
member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection * obj -> unit
Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection, userToken As Object)

Параметры

address
Uri

URI ресурса для получения коллекции. Этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода method.

method
String

Метод HTTP, используемый для отправки строки в ресурс. Если значение NULL, значение по умолчанию — POST для http и STOR для ftp.

data
NameValueCollection

NameValueCollection для отправки в ресурс.

userToken
Object

Определяемый пользователем объект, который передается методу, вызываемого при завершении асинхронной операции.

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр datanull.

WebException

URI, сформированный объединением BaseAddress и address, является недопустимым.

-или-

От сервера, на котором размещен ресурс, не было ответа.

-или-

method нельзя использовать для отправки содержимого.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Этот метод отправляет данные, содержащиеся в NameValueCollection, в ресурс address. Используйте этот метод для отправки данных формы в универсальный код ресурса (URI) для обработки. Данные отправляются с помощью типа носителя form-urlencoded; Значение заголовка Content-Type должно иметь значение application/x-www-form-urlencoded. Заголовок задан правильно по умолчанию. Методы UploadValuesAsync вызывают WebException при вызове этого метода с другим значением заголовка Content-Type, заданным в коллекции Headers.

Если метод method не понимается сервером, базовые классы протоколов определяют, что происходит. Как правило, WebException создается со свойством Status, которое указывает на ошибку.

NameValueCollection отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Чтобы получить уведомление после завершения операции отправки, добавьте обработчик событий в событие UploadValuesCompleted.

Этот метод не блокирует вызывающий поток во время отправки строки. Чтобы отправить строку и блок во время ожидания ответа сервера, используйте один из методов UploadValues.

В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.

Если свойство BaseAddress не является пустой строкой ("") и address не содержит абсолютный универсальный код ресурса (URI), address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не является пустым, оно добавляется в address.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в трассировке сети в.NET Framework.

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