WebClient.OpenWriteTaskAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Открывает поток для записи данных в указанный ресурс в качестве асинхронной операции с помощью объекта задачи. Эти методы не блокируют вызывающий поток.
Перегрузки
| OpenWriteTaskAsync(String) |
Открывает поток для записи данных в указанный ресурс в качестве асинхронной операции с помощью объекта задачи. |
| OpenWriteTaskAsync(Uri) |
Открывает поток для записи данных в указанный ресурс в качестве асинхронной операции с помощью объекта задачи. |
| OpenWriteTaskAsync(String, String) |
Открывает поток для записи данных в указанный ресурс в качестве асинхронной операции с помощью объекта задачи. |
| OpenWriteTaskAsync(Uri, String) |
Открывает поток для записи данных в указанный ресурс в качестве асинхронной операции с помощью объекта задачи. |
OpenWriteTaskAsync(String)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- 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);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address);member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenWriteTaskAsync (address As String) As Task(Of Stream)Параметры
- address
- String
URI ресурса для получения данных.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает Stream, используемый для записи данных в ресурс.
- Атрибуты
Исключения
Параметр addressnull.
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
Произошла ошибка при открытии потока.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Эта операция не блокируется. Возвращенный объект Task<TResult> завершится после открытия записываемого потока в ресурс данных. Этот метод не блокирует вызывающий поток во время открытия потока.
Этот метод извлекает экземпляр Stream, используемый для записи данных в ресурс, указанный параметром address. Поток получается с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.
Заметка
При завершении работы с Stream необходимо вызвать Stream.Close, чтобы избежать использования системных ресурсов.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой ("") и address не содержит абсолютный универсальный код ресурса (URI), address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
См. также раздел
Применяется к
OpenWriteTaskAsync(Uri)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
Открывает поток для записи данных в указанный ресурс в качестве асинхронной операции с помощью объекта задачи.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenWriteTaskAsync(Uri ^ address);public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address);member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenWriteTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenWriteTaskAsync (address As Uri) As Task(Of Stream)Параметры
- address
- Uri
URI ресурса для получения данных.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает Stream, используемый для записи данных в ресурс.
- Атрибуты
Исключения
Параметр addressnull.
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
Произошла ошибка при открытии потока.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Эта операция не блокируется. Возвращенный объект Task<TResult> завершится после открытия записываемого потока в ресурс данных. Этот метод не блокирует вызывающий поток во время открытия потока.
Этот метод извлекает экземпляр Stream, используемый для записи данных в ресурс, указанный параметром address. Поток получается с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.
Заметка
При завершении работы с Stream необходимо вызвать Stream.Close, чтобы избежать использования системных ресурсов.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой ("") и address не содержит абсолютный универсальный код ресурса (URI), address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
Применяется к
OpenWriteTaskAsync(String, String)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- 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);public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (string address, string method);[System.Runtime.InteropServices.ComVisible(false)]
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>[<System.Runtime.InteropServices.ComVisible(false)>]
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.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает Stream, используемый для записи данных в ресурс.
- Атрибуты
Исключения
Параметр addressnull.
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
Произошла ошибка при открытии потока.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Эта операция не блокируется. Возвращенный объект Task<TResult> завершится после открытия записываемого потока в ресурс данных. Этот метод не блокирует вызывающий поток во время открытия потока.
Этот метод извлекает экземпляр Stream, используемый для записи данных в ресурс, указанный параметром address. Поток получается с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.
Заметка
При завершении работы с Stream необходимо вызвать Stream.Close, чтобы избежать использования системных ресурсов.
Если параметр method указывает метод, который не понимается сервером, базовые классы протоколов определяют, что происходит. Как правило, WebException создается со свойством Status, которое указывает на ошибку.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой ("") и address не содержит абсолютный универсальный код ресурса (URI), address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
См. также раздел
Применяется к
OpenWriteTaskAsync(Uri, String)
- Исходный код:
- WebClient.cs
- Исходный код:
- WebClient.cs
- Исходный код:
- 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);public System.Threading.Tasks.Task<System.IO.Stream> OpenWriteTaskAsync (Uri address, string method);[System.Runtime.InteropServices.ComVisible(false)]
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>[<System.Runtime.InteropServices.ComVisible(false)>]
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.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result объекта задачи возвращает Stream, используемый для записи данных в ресурс.
- Атрибуты
Исключения
Параметр addressnull.
URI, сформированный объединением BaseAddress и address, является недопустимым.
-или-
Произошла ошибка при открытии потока.
Комментарии
Осторожность
WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.
Эта операция не блокируется. Возвращенный объект Task<TResult> завершится после открытия записываемого потока в ресурс данных. Этот метод не блокирует вызывающий поток во время открытия потока.
Этот метод извлекает экземпляр Stream, используемый для записи данных в ресурс, указанный параметром address. Поток получается с помощью ресурсов потоков, которые автоматически выделяются из пула потоков.
Заметка
При завершении работы с Stream необходимо вызвать Stream.Close, чтобы избежать использования системных ресурсов.
Если параметр method указывает метод, который не понимается сервером, базовые классы протоколов определяют, что происходит. Как правило, WebException создается со свойством Status, которое указывает на ошибку.
В .NET Framework и .NET Core 1.0 можно отменить асинхронные операции, которые не завершены, вызвав метод CancelAsync.
Если свойство BaseAddress не является пустой строкой ("") и address не содержит абсолютный универсальный код ресурса (URI), address должен быть относительным URI, объединенным с BaseAddress, чтобы сформировать абсолютный URI запрошенных данных. Если свойство QueryString не является пустой строкой, оно добавляется в address.
Этот метод использует команду STOR для отправки ресурса FTP. Для ресурса HTTP используется метод POST.
Этот элемент выводит сведения о трассировке при включении трассировки сети в приложении. Дополнительные сведения см. в разделе Трассировка сети в.NET Framework.
