WebClient.UploadValuesTaskAsync Метод

Определение

Пространство имен:: System.Net

Сборки:: netstandard.dll, System.Net.WebClient.dll

Сборка:: System.Net.WebClient.dll

Сборка:: System.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

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

UploadValuesTaskAsync(String, String, NameValueCollection)

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

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

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

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

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

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(string address, string? method, System.Collections.Specialized.NameValueCollection data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(string address, string method, System.Collections.Specialized.NameValueCollection data);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(string address, string method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : string * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : string * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As String, method As String, data As NameValueCollection) As Task(Of Byte())

Параметры

address: String

URI ресурса для получения коллекции.

method: String

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

data: NameValueCollection

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

Возвращаемое значение

Task<Byte[]>

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает Byte массив, содержащий ответ, отправленный сервером.

Атрибуты: ComVisibleAttribute

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр data имеет значение null.

WebException

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

-или-

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

-или-

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

-или-

Произошла ошибка при открытии потока.

-или-

Заголовок Content-type не является или " null application/x-www-form-urlencoded".

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после отправки коллекции имен и значений в ресурс. Коллекция имен и значений отправляется асинхронно с помощью ресурсов потока, которые автоматически выделяются из пула потоков.

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

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

Если заголовок типа контента имеет значение null"application/x-www-form-urlencoded".

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

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

Заметка

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

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

UploadValuesTaskAsync(String, NameValueCollection)

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

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

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

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

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(System::String ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(string address, System.Collections.Specialized.NameValueCollection data);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(string address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As String, data As NameValueCollection) As Task(Of Byte())

Параметры

address: String

URI ресурса для получения коллекции.

data: NameValueCollection

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

Возвращаемое значение

Task<Byte[]>

Атрибуты: ComVisibleAttribute

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр data имеет значение null.

WebException

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

-или-

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

-или-

Произошла ошибка при открытии потока.

-или-

Заголовок Content-type не является или " null application/x-www-form-urlencoded".

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

UploadValuesTaskAsync(Uri, NameValueCollection)

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

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

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

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

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(Uri address, System.Collections.Specialized.NameValueCollection data);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(Uri address, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : Uri * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : Uri * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As Uri, data As NameValueCollection) As Task(Of Byte())

Параметры

address: Uri

URI ресурса для получения коллекции.

data: NameValueCollection

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

Возвращаемое значение

Task<Byte[]>

Атрибуты: ComVisibleAttribute

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр data имеет значение null.

WebException

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

-или-

Произошла ошибка при открытии потока.

-или-

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

-или-

Значение заголовка Content-type не является и не nullapplication/x-www-form-urlencodedявляется.

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

UploadValuesTaskAsync(Uri, String, NameValueCollection)

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

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

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

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

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

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadValuesTaskAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(Uri address, string? method, System.Collections.Specialized.NameValueCollection data);

public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(Uri address, string method, System.Collections.Specialized.NameValueCollection data);

[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<byte[]> UploadValuesTaskAsync(Uri address, string method, System.Collections.Specialized.NameValueCollection data);

member this.UploadValuesTaskAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.UploadValuesTaskAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> System.Threading.Tasks.Task<byte[]>

Public Function UploadValuesTaskAsync (address As Uri, method As String, data As NameValueCollection) As Task(Of Byte())

Параметры

address: Uri

URI ресурса для получения коллекции.

method: String

data: NameValueCollection

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

Возвращаемое значение

Task<Byte[]>

Атрибуты: ComVisibleAttribute

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр data имеет значение null.

WebException

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

-или-

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

-или-

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

-или-

Произошла ошибка при открытии потока.

-или-

Заголовок Content-type не является или " null application/x-www-form-urlencoded".

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

Обратная связь

Были ли сведения на этой странице полезными?

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

WebClient.UploadValuesTaskAsync Метод

Определение

Перегрузки

UploadValuesTaskAsync(String, String, NameValueCollection)

Параметры

Возвращаемое значение

Исключения

Комментарии

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

UploadValuesTaskAsync(String, NameValueCollection)

Параметры

Возвращаемое значение

Исключения

Комментарии

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

UploadValuesTaskAsync(Uri, NameValueCollection)

Параметры

Возвращаемое значение

Исключения

Комментарии

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

UploadValuesTaskAsync(Uri, String, NameValueCollection)

Параметры

Возвращаемое значение

Исключения

Комментарии

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