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, используемый для записи данных в ресурс.
- Атрибуты
Исключения
Параметр address
имеет значение null
.
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(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, используемый для записи данных в ресурс.
- Атрибуты
Исключения
Параметр address
имеет значение null
.
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
- Исходный код:
- 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
Метод, используемый для передачи данных ресурсу. Если значение пустое, для HTTP по умолчанию используется метод POST, а для FTP — STOR.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает Stream, используемый для записи данных в ресурс.
- Атрибуты
Исключения
Параметр address
имеет значение null
.
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.
См. также раздел
Применяется к
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
Метод, используемый для передачи данных ресурсу. Если значение пустое, для HTTP по умолчанию используется метод POST, а для FTP — STOR.
Возвращаемое значение
Объект задачи, представляющий асинхронную операцию. Свойство Result в объекте задачи возвращает Stream, используемый для записи данных в ресурс.
- Атрибуты
Исключения
Параметр address
имеет значение null
.
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.
См. также раздел
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по