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


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

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

userToken
Object

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

Исключения

Параметр addressnull.

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

-или-

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

Комментарии

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

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

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

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

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

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

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

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

Исключения

Параметр addressnull.

Комментарии

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

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
Исходный код:
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 ресурса для получения данных.

Исключения

Параметр addressnull.

Комментарии

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

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).

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