Прочитать на английском

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


WebRequest.GetRequestStreamAsync Метод

Определение

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

При переопределении в классе-потомке возвращает Stream для записи данных в ресурс Интернета в качестве асинхронной операции.

public virtual System.Threading.Tasks.Task<System.IO.Stream> GetRequestStreamAsync();

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

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

Комментарии

Внимание!

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

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

После вызова GetRequestStreamAsyncубедитесь, что перед вызовом GetResponseAsyncзакройте поток запросов.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых GetRequestStream().

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

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0