WebClient.OpenReadAsync 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. Estes métodos não bloqueiam o fio que chama.
Sobrecargas
| Name | Description |
|---|---|
| OpenReadAsync(Uri) |
Abre um fluxo legível contendo o recurso especificado. Este método não bloqueia o thread que chama. |
| OpenReadAsync(Uri, Object) |
Abre um fluxo legível contendo o recurso especificado. Este método não bloqueia o thread que chama. |
OpenReadAsync(Uri)
Abre um fluxo legível contendo o recurso especificado. Este método não bloqueia o thread que chama.
public:
void OpenReadAsync(Uri ^ address);public void OpenReadAsync(Uri address);member this.OpenReadAsync : Uri -> unitPublic Sub OpenReadAsync (address As Uri)Parâmetros
- address
- Uri
O URI do recurso a recuperar.
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.
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. Para receber notificações quando o stream estiver disponível, adicione um gestor de eventos ao OpenReadCompleted evento.
Note
Deve ligar Stream.Close quando terminar para Stream evitar ficar sem recursos do sistema.
Este método não bloqueia o thread que chama enquanto o fluxo está a abrir. Para bloquear enquanto espera pela transmissão, use o OpenReadAsync método.
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.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por OpenRead(Uri).
Aplica-se a
OpenReadAsync(Uri, Object)
Abre um fluxo legível contendo o recurso especificado. Este método não bloqueia o thread que chama.
public:
void OpenReadAsync(Uri ^ address, System::Object ^ userToken);public void OpenReadAsync(Uri address, object userToken);member this.OpenReadAsync : Uri * obj -> unitPublic Sub OpenReadAsync (address As Uri, userToken As Object)Parâmetros
- address
- Uri
O URI do recurso a recuperar.
- userToken
- Object
Um objeto definido pelo utilizador que é passado para o método invocado quando a operação assíncrona termina.
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.
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. Para receber notificações quando o stream estiver disponível, adicione um gestor de eventos ao OpenReadCompleted evento.
Note
Deve ligar Stream.Close quando terminar para Stream evitar ficar sem recursos do sistema.
Este método não bloqueia o thread que chama enquanto o fluxo está a abrir. Para bloquear enquanto espera pela transmissão, use o OpenRead método.
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.