WebClient.OpenWriteAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Открывает поток для записи данных в указанный ресурс. Эти методы не блокируют вызывающий поток.
Перегрузки
OpenWriteAsync(Uri, String, Object) |
Открывает поток для записи данных в указанный ресурс с помощью указанного метода. Этот метод не блокирует вызывающий поток. |
OpenWriteAsync(Uri, String) |
Открывает поток для записи данных в указанный ресурс. Этот метод не блокирует вызывающий поток. |
OpenWriteAsync(Uri) |
Открывает поток для записи данных в указанный ресурс. Этот метод не блокирует вызывающий поток. |
OpenWriteAsync(Uri, String, Object)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Открывает поток для записи данных в указанный ресурс с помощью указанного метода. Этот метод не блокирует вызывающий поток.
public:
void OpenWriteAsync(Uri ^ address, System::String ^ method, System::Object ^ userToken);
public void OpenWriteAsync (Uri address, string? method, 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
Пользовательский объект, передаваемый методу, вызываемому по завершении асинхронной операции.
Исключения
Параметр address
имеет значение null
.
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
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Открывает поток для записи данных в указанный ресурс. Этот метод не блокирует вызывающий поток.
public:
void OpenWriteAsync(Uri ^ address, System::String ^ method);
public void OpenWriteAsync (Uri address, 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.
Исключения
Параметр address
имеет значение null
.
Комментарии
Этот метод извлекает доступный для записи поток, который используется для отправки данных в ресурс. Поток извлекается с помощью ресурсов потока, которые автоматически выделяются из пула потоков. Чтобы получать уведомление о доступности потока, добавьте обработчик событий к событию OpenWriteCompleted . При закрытии потока поток блокируется до отправки address
запроса и получения ответа.
Этот метод не блокирует вызывающий поток во время открытия потока. Чтобы заблокировать во время ожидания потока, используйте один из OpenWrite методов .
BaseAddress Если свойство не является пустой строкой ("") и address
не содержит абсолютный URI, то это должен быть относительный URI, address
который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется к address
.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые OpenWrite(Uri, String).
Применяется к
OpenWriteAsync(Uri)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- 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 ресурса, которому передаются данные.
Исключения
Параметр address
имеет значение null
.
Комментарии
Этот метод извлекает доступный для записи поток, который используется для отправки данных в ресурс. Поток извлекается с помощью ресурсов потока, которые автоматически выделяются из пула потоков. Чтобы получать уведомление о доступности потока, добавьте обработчик событий к событию OpenWriteCompleted . При закрытии потока поток блокируется до отправки address
запроса и получения ответа.
Этот метод не блокирует вызывающий поток во время открытия потока. Чтобы заблокировать во время ожидания потока, используйте один из OpenWrite методов .
BaseAddress Если свойство не является пустой строкой ("") и address
не содержит абсолютный URI, то это должен быть относительный URI, address
который объединяется с BaseAddress для формирования абсолютного URI запрошенных данных. QueryString Если свойство не является пустой строкой, оно добавляется к address
.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Примечание
Данный член генерирует сведения трассировки, если в приложении включена трассировка сети. Дополнительные сведения см. в статье Трассировка сети в платформа .NET Framework.
Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые OpenWrite(Uri).
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по