WebClient.OpenWriteTaskAsync Метод

Определение

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

System.Net

Сборки:

netstandard.dll, System.Net.WebClient.dll

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

Перегрузки

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

OpenWriteTaskAsync(String)

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

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync(string address);

member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As String) As Task(Of Stream)

Параметры

address

String

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

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

Task<Stream>

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

Исключения

ArgumentNullException

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

WebException

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

-или-

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

Комментарии

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

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

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

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

Заметка

При завершении Stream.Close работы необходимо вызватьStream, чтобы избежать выхода из системных ресурсов.

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

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

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

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

См. также раздел

• Stream

OpenWriteTaskAsync(Uri)

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

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync(Uri address);

member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As Uri) As Task(Of Stream)

Параметры

address

Uri

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

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

Task<Stream>

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

Исключения

ArgumentNullException

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

WebException

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

-или-

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

Комментарии

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

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

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

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

Заметка

При завершении Stream.Close работы необходимо вызватьStream, чтобы избежать выхода из системных ресурсов.

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

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

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

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

OpenWriteTaskAsync(String, String)

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

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(System::String ^ address, System::String ^ method);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync(string address, string? method);

member this.OpenWriteTaskAsync : string * string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As String, method As String) As Task(Of Stream)

Параметры

address

String

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

method

String

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

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

Task<Stream>

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

Исключения

ArgumentNullException

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

WebException

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

-или-

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

Комментарии

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

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

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

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

Заметка

При завершении Stream.Close работы необходимо вызватьStream, чтобы избежать выхода из системных ресурсов.

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

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

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

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

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

См. также раздел

• Stream

OpenWriteTaskAsync(Uri, String)

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

WebClient.cs

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

public:
 System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address, System::String ^ method);

public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync(Uri address, string? method);

member this.OpenWriteTaskAsync : Uri * string -> System.Threading.Tasks.Task<System.IO.Stream>

Public Function OpenWriteTaskAsync (address As Uri, method As String) As Task(Of Stream)

Параметры

address

Uri

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

method

String

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

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

Task<Stream>

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

Исключения

ArgumentNullException

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

WebException

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

-или-

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

Комментарии

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

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

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

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

Заметка

При завершении Stream.Close работы необходимо вызватьStream, чтобы избежать выхода из системных ресурсов.

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

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

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

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

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

См. также раздел

• Stream