WebClient.UploadValuesTaskAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выгружает указанную коллекцию "имя-значение" в указанный ресурс, определенный с помощью 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
Выгружает указанную коллекцию "имя-значение" в указанный ресурс, определенный с помощью 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, используемый для передачи коллекции ресурсу. Если значение пустое, для HTTP по умолчанию используется метод POST, а для FTP — STOR.
- data
- NameValueCollection
Коллекция NameValueCollection, передаваемая ресурсу.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает массив Byte, содержащий ответ, отправленный сервером.
- Атрибуты
Исключения
Параметр address
имеет значение null
.
-или-
Параметр data
имеет значение null
.
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
- Исходный код:
- WebClient.cs
- Исходный код:
- 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);
[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, передаваемая ресурсу.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает массив Byte, содержащий ответ, отправленный сервером.
- Атрибуты
Исключения
Параметр address
имеет значение null
.
-или-
Параметр data
имеет значение null
.
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
- Исходный код:
- WebClient.cs
- Исходный код:
- 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);
[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, передаваемая ресурсу.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает массив Byte, содержащий ответ, отправленный сервером.
- Атрибуты
Исключения
Параметр address
имеет значение null
.
-или-
Параметр data
имеет значение null
.
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
- Исходный код:
- WebClient.cs
- Исходный код:
- 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);
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
Метод HTTP, используемый для передачи коллекции ресурсу. Если значение пустое, для HTTP по умолчанию используется метод POST, а для FTP — STOR.
- data
- NameValueCollection
Коллекция NameValueCollection, передаваемая ресурсу.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает массив Byte, содержащий ответ, отправленный сервером.
- Атрибуты
Исключения
Параметр address
имеет значение null
.
-или-
Параметр data
имеет значение null
.
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.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по