WebClient.OpenWriteAsync Метод

Определение

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

System.Net

Сборка:

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

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

userToken

Object

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

Исключения

ArgumentNullException

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

WebException

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

-или-

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

Комментарии

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

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

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

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

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

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

Исключения

ArgumentNullException

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

Комментарии

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

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

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

Комментарии

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

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

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

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

Примечание

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

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