WebClient.UploadStringTaskAsync Метод

Определение

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

System.Net

Сборка:

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, используемый для передачи файла ресурсу. Если значение пустое, для HTTP по умолчанию используется метод POST, а для FTP — STOR.

data

String

Выгружаемая строка.

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

Task<String>

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

Исключения

ArgumentNullException

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

-или-

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

WebException

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

-или-

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

-или-

Сервер, на котором расположен ресурс, не отвечает.

Комментарии

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

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

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

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, то должен быть относительным URI, address который объединяется с 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, используемый для передачи файла ресурсу. Если значение пустое, для HTTP по умолчанию используется метод POST, а для FTP — STOR.

data

String

Выгружаемая строка.

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

Task<String>

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

Исключения

ArgumentNullException

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

-или-

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

WebException

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

-или-

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

-или-

Сервер, на котором расположен ресурс, не отвечает.

Комментарии

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

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

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

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, то должен быть относительным URI, address который объединяется с 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, является недопустимым.

-или-

Сервер, на котором расположен ресурс, не отвечает.

Комментарии

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

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

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

BaseAddress Если свойство не является пустой строкой ("") и address не содержит абсолютный URI, то должен быть относительным URI, address который объединяется с 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, является недопустимым.

-или-

Сервер, на котором расположен ресурс, не отвечает.

Комментарии

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

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

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

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

Примечание

Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.