WebClient.OpenWriteTaskAsync Метод

Определение

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

System.Net

Сборка:

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, является недопустимым.

-или-

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

Комментарии

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

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

Примечание

Чтобы избежать переполнения системных ресурсов, необходимо вызвать по Stream.Close завершении работы с Stream .

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

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

-или-

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

Комментарии

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

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

Примечание

Чтобы избежать переполнения системных ресурсов, необходимо вызвать по Stream.Close завершении работы с Stream .

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

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

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

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

Task<Stream>

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

Исключения

ArgumentNullException

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

WebException

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

-или-

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

Комментарии

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

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

Примечание

Чтобы избежать переполнения системных ресурсов, необходимо вызвать по Stream.Close завершении работы с Stream .

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

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

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

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

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

Task<Stream>

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

Исключения

ArgumentNullException

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

WebException

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

-или-

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

Комментарии

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

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

Примечание

Чтобы избежать переполнения системных ресурсов, необходимо вызвать команду Stream.Close после завершения работы с Stream .

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

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

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

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

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

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

• Stream