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, содержащую ответ, отправленный сервером.
- Атрибуты
Исключения
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, содержащую ответ, отправленный сервером.
- Атрибуты
Исключения
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, содержащую ответ, отправленный сервером.
- Атрибуты
Исключения
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, содержащую ответ, отправленный сервером.
- Атрибуты
Исключения
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.
