WebClient.UploadStringTaskAsync Метод

Определение

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

System.Net

Сборки:

netstandard.dll, System.Net.WebClient.dll

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

Перегрузки

Имя	Описание
UploadStringTaskAsync(Uri, String, String)	Отправляет указанную строку в указанный ресурс в качестве асинхронной операции с помощью объекта задачи.
UploadStringTaskAsync(String, String, String)	Отправляет указанную строку в указанный ресурс в качестве асинхронной операции с помощью объекта задачи.
UploadStringTaskAsync(String, String)	Отправляет указанную строку в указанный ресурс в качестве асинхронной операции с помощью объекта задачи.
UploadStringTaskAsync(Uri, String)	Отправляет указанную строку в указанный ресурс в качестве асинхронной операции с помощью объекта задачи.

UploadStringTaskAsync(Uri, String, String)

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

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ method, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync(Uri address, string? method, string data);

member this.UploadStringTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As Uri, method As String, data As String) As Task(Of String)

Параметры

address

Uri

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

method

String

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

data

String

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

Возвращаемое значение

Task<String>

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает String ответ, отправленный сервером.

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр data имеет значение null.

WebException

URI, сформированный BaseAddress объединением и address недопустимым.

-или-

method не может использоваться для отправки содержимого.

-или-

От сервера, на котором размещен ресурс, не было ответа.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после отправки строки в ресурс. Строка отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.

В .NET Framework можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.

Перед отправкой строки этот метод преобразует его в Byte массив с помощью кодировки, указанной в свойстве Encoding . Этот метод блокирует передачу строки.

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, address должен быть относительным универсальным кодом ресурса (URI), который объединяется с BaseAddress абсолютным URI запрошенных данных. QueryString Если свойство не является пустой строкой, она добавляется в address.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.

UploadStringTaskAsync(String, String, String)

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

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ method, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync(string address, string? method, string data);

member this.UploadStringTaskAsync : string * string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As String, method As String, data As String) As Task(Of String)

Параметры

address

String

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

method

String

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

data

String

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

Возвращаемое значение

Task<String>

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает String ответ, отправленный сервером.

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр data имеет значение null.

WebException

URI, сформированный BaseAddress объединением и address недопустимым.

-или-

method не может использоваться для отправки содержимого.

-или-

От сервера, на котором размещен ресурс, не было ответа.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после отправки строки в ресурс. Строка отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.

В .NET Framework можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.

Перед отправкой строки этот метод преобразует его в Byte массив с помощью кодировки, указанной в свойстве Encoding . Этот метод блокирует передачу строки.

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, address должен быть относительным универсальным кодом ресурса (URI), который объединяется с BaseAddress абсолютным URI запрошенных данных. QueryString Если свойство не является пустой строкой, она добавляется в address.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.

UploadStringTaskAsync(String, String)

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

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(System::String ^ address, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync(string address, string data);

member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As String, data As String) As Task(Of String)

Параметры

address

String

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

data

String

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

Возвращаемое значение

Task<String>

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает String ответ, отправленный сервером.

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр data имеет значение null.

WebException

URI, сформированный BaseAddress объединением и address недопустимым.

-или-

От сервера, на котором размещен ресурс, не было ответа.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после отправки строки в ресурс. Строка отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.

В .NET Framework можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.

Перед отправкой строки этот метод преобразует его в Byte массив с помощью кодировки, указанной в свойстве Encoding . Этот метод блокирует передачу строки.

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, address должен быть относительным универсальным кодом ресурса (URI), который объединяется с BaseAddress абсолютным URI запрошенных данных. QueryString Если свойство не является пустой строкой, она добавляется в address.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.

UploadStringTaskAsync(Uri, String)

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

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::String ^> ^ UploadStringTaskAsync(Uri ^ address, System::String ^ data);

public System.Threading.Tasks.Task<string> UploadStringTaskAsync(Uri address, string data);

member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>

Public Function UploadStringTaskAsync (address As Uri, data As String) As Task(Of String)

Параметры

address

Uri

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

data

String

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

Возвращаемое значение

Task<String>

Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает String ответ, отправленный сервером.

Исключения

ArgumentNullException

Параметр address имеет значение null.

-или-

Параметр data имеет значение null.

WebException

URI, сформированный BaseAddress объединением и address недопустимым.

-или-

От сервера, на котором размещен ресурс, не было ответа.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи устарели, и WebClient вы не должны использовать их для новой разработки. Вместо этого используйте HttpClient.

Эта операция не блокируется. Возвращенный Task<TResult> объект завершится после отправки строки в ресурс. Строка отправляется асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.

В .NET Framework можно отменить асинхронные операции, которые не завершены путем вызова CancelAsync метода.

Перед отправкой строки этот метод преобразует его в Byte массив с помощью кодировки, указанной в свойстве Encoding . Этот метод блокирует передачу строки.

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, address должен быть относительным универсальным кодом ресурса (URI), который объединяется с BaseAddress абсолютным URI запрошенных данных. QueryString Если свойство не является пустой строкой, она добавляется в address.

Заметка

Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе "Трассировка сети" в .NET Framework.