WebClient.UploadValuesTaskAsync Метод

Определение

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

System.Net

Сборка:

System.Net.WebClient.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

Отправляет указанную коллекцию имен и значений в ресурс, определенный указанным универсальным кодом ресурса (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);

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, содержащий ответ, отправленный сервером.

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр datanull.

WebException

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

-или-

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

-или-

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

-или-

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

-или-

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

Комментарии

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

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

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

В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод 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

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

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);

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[]>

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

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр datanull.

WebException

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

-или-

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

-или-

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

-или-

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

Комментарии

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

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

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

В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод 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(Uri, NameValueCollection)

Исходный код:

WebClient.cs

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

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);

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[]>

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

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр datanull.

WebException

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

-или-

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

-или-

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

-или-

Значение заголовка Content-type не null и не application/x-www-form-urlencoded.

Комментарии

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

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

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

В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод 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(Uri, String, NameValueCollection)

Исходный код:

WebClient.cs

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

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);

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

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

data

NameValueCollection

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

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

Task<Byte[]>

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

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр datanull.

WebException

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

-или-

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

-или-

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

-или-

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

-или-

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

Комментарии

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

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

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

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

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

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

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

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

Заметка

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