Поделиться через


WebClient.UploadStringTaskAsync Метод

Определение

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

Перегрузки

UploadStringTaskAsync(Uri, String, String)

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

UploadStringTaskAsync(String, String, String)

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

UploadStringTaskAsync(String, String)

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

UploadStringTaskAsync(Uri, String)

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

UploadStringTaskAsync(Uri, String, String)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
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);
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string method, string data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string method, string data);
member this.UploadStringTaskAsync : Uri * string * string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
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

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

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

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

Атрибуты

Исключения

Параметр addressnull.

-или-

Параметр datanull.

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

-или-

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

-или-

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

Комментарии

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

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

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

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

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

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

Заметка

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

Применяется к

UploadStringTaskAsync(String, String, String)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
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);
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string method, string data);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string method, string data);
member this.UploadStringTaskAsync : string * string * string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
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

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

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

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

Атрибуты

Исключения

Параметр addressnull.

-или-

Параметр datanull.

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

-или-

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

-или-

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

Комментарии

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

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

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

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

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

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

Заметка

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

Применяется к

UploadStringTaskAsync(String, String)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (string address, string data);
member this.UploadStringTaskAsync : string * string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
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

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

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

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

Атрибуты

Исключения

Параметр addressnull.

-или-

Параметр datanull.

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

-или-

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

Комментарии

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

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

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

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

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

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

Заметка

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

Применяется к

UploadStringTaskAsync(Uri, String)

Исходный код:
WebClient.cs
Исходный код:
WebClient.cs
Исходный код:
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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> UploadStringTaskAsync (Uri address, string data);
member this.UploadStringTaskAsync : Uri * string -> System.Threading.Tasks.Task<string>
[<System.Runtime.InteropServices.ComVisible(false)>]
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

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

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

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

Атрибуты

Исключения

Параметр addressnull.

-или-

Параметр datanull.

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

-или-

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

Комментарии

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

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

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

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

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

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

Заметка

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

Применяется к