WebClient.UploadStringAsync Метод

Определение

Пространство имен:

System.Net

Сборка:

System.Net.WebClient.dll

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

Перегрузки

UploadStringAsync(Uri, String)	Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.
UploadStringAsync(Uri, String, String)	Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.
UploadStringAsync(Uri, String, String, Object)	Отправляет указанную строку в указанный ресурс. Этот метод не блокирует вызывающий поток.

UploadStringAsync(Uri, String)

Исходный код:

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

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

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр datanull.

WebException

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).

UploadStringAsync(Uri, String, String)

Исходный код:

WebClient.cs

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

public:
 void UploadStringAsync(Uri ^ address, System::String ^ method, System::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

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

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр datanull.

WebException

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).

UploadStringAsync(Uri, String, String, Object)

Исходный код:

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);

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

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

Исключения

ArgumentNullException

Параметр addressnull.

-или-

Параметр datanull.

WebException

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.