WebClient.UploadStringAsync Метод

Определение

Отправляет указанную строку в указанный ресурс. Эти методы не блокируют вызывающий поток.

Перегрузки

UploadStringAsync(Uri, String)

Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.

UploadStringAsync(Uri, String, String)

Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.

UploadStringAsync(Uri, String, String, Object)

Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.

UploadStringAsync(Uri, String)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
WebClient.cs

Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.

public void UploadStringAsync (Uri address, string data);

Параметры

address
Uri

URI ресурса для получения строки. Для ресурсов HTTP этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода POST, например скрипта или страницы ASP.

data
String

Строка для отправки.

Исключения

Параметр addressnull.

-или-

Параметр datanull.

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

UploadStringAsync(Uri, String, String)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
WebClient.cs

Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.

public void UploadStringAsync (Uri address, string? method, string data);
public void UploadStringAsync (Uri address, string method, string data);

Параметры

address
Uri

URI ресурса для получения строки. Для ресурсов HTTP этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода POST, например скрипта или страницы ASP.

method
String

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

data
String

Строка для отправки.

Исключения

Параметр addressnull.

-или-

Параметр datanull.

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

UploadStringAsync(Uri, String, String, Object)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
WebClient.cs

Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.

public void UploadStringAsync (Uri address, string? method, string data, object? userToken);
public void UploadStringAsync (Uri address, string method, string data, object userToken);

Параметры

address
Uri

URI ресурса для получения строки. Для ресурсов HTTP этот URI должен определить ресурс, который может принимать запрос, отправленный с помощью метода POST, например скрипта или страницы ASP.

method
String

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

data
String

Строка для отправки.

userToken
Object

Определяемый пользователем объект, который передается методу, вызываемого при завершении асинхронной операции.

Исключения

Параметр addressnull.

-или-

Параметр datanull.

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