WebClient.OpenReadTaskAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Abre um fluxo legível contendo o recurso especificado como uma operação assíncrona usando um objeto tarefa. Estes métodos não bloqueiam o fio que chama.
Sobrecargas
| Name | Description |
|---|---|
| OpenReadTaskAsync(String) |
Abre um fluxo legível contendo o recurso especificado como uma operação assíncrona usando um objeto tarefa. |
| OpenReadTaskAsync(Uri) |
Abre um fluxo legível contendo o recurso especificado como uma operação assíncrona usando um objeto tarefa. |
OpenReadTaskAsync(String)
Abre um fluxo legível contendo o recurso especificado como uma operação assíncrona usando um objeto tarefa.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(System::String ^ address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(string address);public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(string address);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>member this.OpenReadTaskAsync : string -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenReadTaskAsync (address As String) As Task(Of Stream)Parâmetros
- address
- String
O URI do recurso a recuperar.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um Stream usado para ler dados de um recurso.
- Atributos
Exceções
O address parâmetro é null.
O URI formado pela combinação BaseAddress e endereço é inválido.
-ou-
Ocorreu um erro durante o download do recurso.
-ou-
Ocorreu um erro ao abrir a transmissão.
Observações
Atenção
WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído depois de um fluxo legível para o recurso de dados ter sido aberto. Este método não bloqueia o thread que chama enquanto o fluxo está a abrir.
Este método recupera uma Stream instância usada para aceder ao recurso especificado pelo address parâmetro. O fluxo é obtido usando recursos de threads que são automaticamente alocados a partir do pool de threads.
Note
Deve ligar Stream.Close quando terminar para Stream evitar ficar sem recursos do sistema.
No .NET Framework, pode cancelar operações assíncronas que não tenham sido concluídas chamando o método CancelAsync.
Se a BaseAddress propriedade não for uma cadeia vazia ("") e address não especificar um URI absoluto, address deve ser um URI relativo que é combinado com BaseAddress para formar o URI absoluto do recurso solicitado. Se a QueryString propriedade não nullfor , é anexada a address.
Este método utiliza o comando RETR para descarregar um recurso FTP. Para um recurso HTTP, utiliza-se o método GET.
Note
Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Network Tracing in .NET Framework.
Ver também
Aplica-se a
OpenReadTaskAsync(Uri)
Abre um fluxo legível contendo o recurso especificado como uma operação assíncrona usando um objeto tarefa.
public:
System::Threading::Tasks::Task<System::IO::Stream ^> ^ OpenReadTaskAsync(Uri ^ address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(Uri address);public System.Threading.Tasks.Task<System.IO.Stream> OpenReadTaskAsync(Uri address);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>member this.OpenReadTaskAsync : Uri -> System.Threading.Tasks.Task<System.IO.Stream>Public Function OpenReadTaskAsync (address As Uri) As Task(Of Stream)Parâmetros
- address
- Uri
O URI do recurso a recuperar.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um Stream usado para ler dados de um recurso.
- Atributos
Exceções
O address parâmetro é null.
O URI formado pela combinação BaseAddress e endereço é inválido.
-ou-
Ocorreu um erro durante o download do recurso.
-ou-
Ocorreu um erro ao abrir a transmissão.
Observações
Atenção
WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.
Esta operação não vai bloquear. O objeto devolvido Task<TResult> será concluído depois de um fluxo legível para o recurso de dados ter sido aberto. Este método não bloqueia o thread que chama enquanto o fluxo está a abrir.
Este método recupera uma Stream instância usada para aceder ao recurso especificado pelo address parâmetro. O fluxo é obtido usando recursos de threads que são automaticamente alocados a partir do pool de threads.
Note
Deve ligar Stream.Close quando terminar para Stream evitar ficar sem recursos do sistema.
No .NET Framework, pode cancelar operações assíncronas que não tenham sido concluídas chamando o método CancelAsync.
Se a BaseAddress propriedade não for uma cadeia vazia ("") e address não especificar um URI absoluto, address deve ser um URI relativo que é combinado com BaseAddress para formar o URI absoluto do recurso solicitado. Se a QueryString propriedade não nullfor , é anexada a address.
Este método utiliza o comando RETR para descarregar um recurso FTP. Para um recurso HTTP, utiliza-se o método GET.
Note
Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para mais informações, consulte Network Tracing in .NET Framework.