WebClient.UploadValuesAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Передает указанную коллекцию "имя-значение" указанному ресурсу, указанному с помощью 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, передаваемая ресурсу.
Исключения
Параметр address
имеет значение null
.
-или-
Параметр data
имеет значение null
.
URI, образованный объединением BaseAddress и address
, является недопустимым.
-или-
Сервер, на котором расположен ресурс, не отвечает.
Комментарии
Этот метод отправляет строку в ресурс. Строка отправляется асинхронно с использованием ресурсов потока, которые автоматически выделяются из пула потоков. Перед отправкой строки этот метод преобразует ее в Byte массив с использованием кодировки, указанной в свойстве Encoding . Чтобы получать уведомление о завершении отправки строки, можно добавить в событие обработчик UploadStringCompleted события.
Этот метод не блокирует вызывающий поток во время отправки строки. Чтобы отправить строку и блок во время ожидания ответа сервера, используйте один из UploadString методов .
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не были завершены, вызвав CancelAsync метод .
BaseAddress Если свойство не является пустой строкой ("") и address
не содержит абсолютный URI, то это должен быть относительный URI, address
который объединяется с 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
Метод, используемый для передачи строки ресурсу. Если значение пустое, для HTTP по умолчанию используется метод POST, а для FTP — STOR.
- data
- NameValueCollection
Коллекция NameValueCollection, передаваемая ресурсу.
Исключения
Параметр address
имеет значение null
.
-или-
Параметр data
имеет значение null
.
URI, образованный объединением BaseAddress и address
, является недопустимым.
-или-
Сервер, на котором расположен ресурс, не отвечает.
-или-
Метод method
не может использоваться для отправки содержимого.
Комментарии
Этот метод отправляет данные, содержащиеся в 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, то это должен быть относительный URI, address
который объединяется с 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, используемый для передачи строки ресурсу. Если значение пустое, для HTTP по умолчанию используется метод POST, а для FTP — STOR.
- data
- NameValueCollection
Коллекция NameValueCollection, передаваемая ресурсу.
- userToken
- Object
Пользовательский объект, передаваемый методу, вызываемому по завершении асинхронной операции.
Исключения
Параметр address
имеет значение null
.
-или-
Параметр data
имеет значение null
.
URI, образованный объединением BaseAddress и address
, является недопустимым.
-или-
Сервер, на котором расположен ресурс, не отвечает.
-или-
Метод method
не может использоваться для отправки содержимого.
Комментарии
Этот метод отправляет данные, содержащиеся в 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, то это должен быть относительный URI, address
который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных.
QueryString Если свойство не является пустым, оно добавляется к address
.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в .NET Framework.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по