WebClient.OpenWriteAsync Метод

Определение

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

System.Net

Сборки:

netstandard.dll, System.Net.WebClient.dll

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

Перегрузки

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

OpenWriteAsync(Uri, String, Object)

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

WebClient.cs

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

public:
 void OpenWriteAsync(Uri ^ address, System::String ^ method, System::Object ^ userToken);

public void OpenWriteAsync(Uri address, string? method, object? userToken);

member this.OpenWriteAsync : Uri * string * obj -> unit

Public Sub OpenWriteAsync (address As Uri, method As String, userToken As Object)

Параметры

address

Uri

URI ресурса для получения данных.

method

String

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

userToken

Object

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

Исключения

ArgumentNullException

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

WebException

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

-или-

Произошла ошибка при открытии потока.

Комментарии

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

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

Этот метод извлекает записываемый поток, используемый для отправки данных в ресурс. Поток извлекается асинхронно с помощью ресурсов потоков, которые автоматически выделяются из пула потоков. Чтобы получить уведомление о доступности потока, добавьте обработчик событий в OpenWriteCompleted событие. Содержимое потока отправляется серверу при закрытии потока.

method Если параметр задает метод, который не понимается сервером, базовые классы протоколов определяют, что происходит. Как правило, WebException создается исключение со свойством Status , которое указывает на ошибку.

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

Этот метод не блокирует вызывающий поток во время открытия потока. Чтобы заблокировать время ожидания потока, используйте один из OpenWrite методов.

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

Заметка

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

OpenWriteAsync(Uri, String)

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

WebClient.cs

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

public:
 void OpenWriteAsync(Uri ^ address, System::String ^ method);

public void OpenWriteAsync(Uri address, string? method);

member this.OpenWriteAsync : Uri * string -> unit

Public Sub OpenWriteAsync (address As Uri, method As String)

Параметры

address

Uri

URI ресурса для получения данных.

method

String

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

Исключения

ArgumentNullException

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

Комментарии

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

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

Этот метод извлекает записываемый поток, используемый для отправки данных в ресурс. Поток извлекается с помощью ресурсов потока, которые автоматически выделяются из пула потоков. Чтобы получить уведомление о доступности потока, добавьте обработчик событий в OpenWriteCompleted событие. При закрытии потока поток блокируется до отправки address запроса и получения ответа.

Этот метод не блокирует вызывающий поток во время открытия потока. Чтобы заблокировать время ожидания потока, используйте один из OpenWrite методов.

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

Заметка

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

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

OpenWriteAsync(Uri)

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

WebClient.cs

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

public:
 void OpenWriteAsync(Uri ^ address);

public void OpenWriteAsync(Uri address);

member this.OpenWriteAsync : Uri -> unit

Public Sub OpenWriteAsync (address As Uri)

Параметры

address

Uri

URI ресурса для получения данных.

Исключения

ArgumentNullException

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

Комментарии

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

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

Этот метод извлекает записываемый поток, используемый для отправки данных в ресурс. Поток извлекается с помощью ресурсов потока, которые автоматически выделяются из пула потоков. Чтобы получить уведомление о доступности потока, добавьте обработчик событий в OpenWriteCompleted событие. При закрытии потока поток блокируется до отправки address запроса и получения ответа.

Этот метод не блокирует вызывающий поток во время открытия потока. Чтобы заблокировать время ожидания потока, используйте один из OpenWrite методов.

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

Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.

Заметка

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

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