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, используемый для передачи коллекции ресурсу. Если значение пустое, для HTTP по умолчанию используется метод POST, а для FTP — STOR.

data

NameValueCollection

Коллекция NameValueCollection, передаваемая ресурсу.

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

Task<Byte[]>

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

Исключения

ArgumentNullException

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

-или-

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

WebException

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

-или-

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

-или-

Сервер, на котором расположен ресурс, не отвечает.

-или-

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

-или-

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

Комментарии

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

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

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

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

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, должен быть относительным URI, address объединенным с 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

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

-или-

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

WebException

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

-или-

Сервер, на котором расположен ресурс, не отвечает.

-или-

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

-или-

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

Комментарии

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

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

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

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

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, должен быть относительным URI, address объединенным с 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

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

-или-

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

WebException

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

-или-

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

-или-

Сервер, на котором расположен ресурс, не отвечает.

-или-

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

Комментарии

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

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

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

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

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, должен быть относительным URI, address объединенным с 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, используемый для передачи коллекции ресурсу. Если значение пустое, для HTTP по умолчанию используется метод POST, а для FTP — STOR.

data

NameValueCollection

Коллекция NameValueCollection, передаваемая ресурсу.

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

Task<Byte[]>

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

Исключения

ArgumentNullException

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

-или-

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

WebException

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

-или-

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

-или-

Сервер, на котором расположен ресурс, не отвечает.

-или-

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

-или-

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

Комментарии

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

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

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

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

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

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

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.