WebClient.UploadStringAsync Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отправляет указанную строку в указанный ресурс. Эти методы не блокируют вызывающий поток.
UploadStringAsync(Uri, String) |
Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток. |
UploadStringAsync(Uri, String, String) |
Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток. |
UploadStringAsync(Uri, String, String, Object) |
Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток. |
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.
public:
void UploadStringAsync(Uri ^ address, System::String ^ data);
public void UploadStringAsync (Uri address, string data);
member this.UploadStringAsync : Uri * string -> unit
Public Sub UploadStringAsync (address As Uri, data As String)
Параметры
- address
- Uri
URI ресурса для получения строки. Для ресурсов HTTP этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода POST, например скрипта или страницы ASP.
- data
- String
Строка для отправки.
Исключения
URI, сформированный объединением BaseAddress и address
, является недопустимым.
-или-
От сервера, на котором размещен ресурс, не было ответа.
Комментарии
Внимание!
WebRequest
, HttpWebRequest
, ServicePoint
и WebClient
устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Этот метод отправляет строку в ресурс. Строка отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Перед отправкой строки этот метод преобразует его в массив Byte с помощью кодировки, указанной в свойстве Encoding. Чтобы получить уведомление после завершения отправки строки, можно добавить обработчик событий в событие UploadStringCompleted.
Этот метод не блокирует вызывающий поток во время отправки строки. Чтобы отправить строку и блок во время ожидания ответа сервера, используйте один из методов UploadString.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой ("") и address
не содержит абсолютный универсальный код ресурса (URI), address
должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address
.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Примечание
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых UploadString(Uri, String).
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.
public:
void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data);
public void UploadStringAsync (Uri address, string? method, string data);
public void UploadStringAsync (Uri address, string method, string data);
member this.UploadStringAsync : Uri * string * string -> unit
Public Sub UploadStringAsync (address As Uri, method As String, data As String)
Параметры
- address
- Uri
URI ресурса для получения строки. Для ресурсов HTTP этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода POST, например скрипта или страницы ASP.
- method
- String
Метод HTTP, используемый для отправки файла в ресурс. Если значение NULL, значение по умолчанию — POST для http и STOR для ftp.
- data
- String
Строка для отправки.
Исключения
URI, сформированный объединением BaseAddress и address
, является недопустимым.
-или-
method
нельзя использовать для отправки содержимого.
-или-
От сервера, на котором размещен ресурс, не было ответа.
Комментарии
Внимание!
WebRequest
, HttpWebRequest
, ServicePoint
и WebClient
устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Этот метод отправляет строку в ресурс. Строка отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Перед отправкой строки этот метод преобразует его в массив Byte с помощью кодировки, указанной в свойстве Encoding. Чтобы получить уведомление после завершения отправки строки, можно добавить обработчик событий в событие UploadStringCompleted.
Этот метод не блокирует вызывающий поток во время отправки строки. Чтобы отправить строку и блок во время ожидания ответа сервера, используйте один из методов UploadString.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой ("") и address
не содержит абсолютный универсальный код ресурса (URI), address
должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address
.
Примечание
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых UploadString(Uri, String, String).
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.
public:
void UploadStringAsync(Uri ^ address, System::String ^ method, System::String ^ data, System::Object ^ userToken);
public void UploadStringAsync (Uri address, string? method, string data, object? userToken);
public void UploadStringAsync (Uri address, string method, string data, object userToken);
member this.UploadStringAsync : Uri * string * string * obj -> unit
Public Sub UploadStringAsync (address As Uri, method As String, data As String, userToken As Object)
Параметры
- address
- Uri
URI ресурса для получения строки. Для ресурсов HTTP этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода POST, например скрипта или страницы ASP.
- method
- String
Метод HTTP, используемый для отправки файла в ресурс. Если значение NULL, значение по умолчанию — POST для http и STOR для ftp.
- data
- String
Строка для отправки.
- userToken
- Object
Определяемый пользователем объект, который передается методу, вызываемого при завершении асинхронной операции.
Исключения
URI, сформированный объединением BaseAddress и address
, является недопустимым.
-или-
method
нельзя использовать для отправки содержимого.
-или-
От сервера, на котором размещен ресурс, не было ответа.
Комментарии
Внимание!
WebRequest
, HttpWebRequest
, ServicePoint
и WebClient
устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Этот метод отправляет строку в ресурс. Строка отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Перед отправкой строки этот метод преобразует его в массив Byte с помощью кодировки, указанной в свойстве Encoding. Чтобы получить уведомление после завершения отправки строки, можно добавить обработчик событий в событие UploadStringCompleted.
Этот метод не блокирует вызывающий поток во время отправки строки. Чтобы отправить строку и блок во время ожидания ответа сервера, используйте один из методов UploadString.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой ("") и address
не содержит абсолютный универсальный код ресурса (URI), address
должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address
.
Примечание
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: