WebClient.DownloadStringTaskAsync 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.
Descarrega o recurso como um String a partir do URI especificado como uma operação assíncrona usando um objeto tarefa. Estes métodos não bloqueiam o fio que chama.
Sobrecargas
| Name | Description |
|---|---|
| DownloadStringTaskAsync(String) |
Descarrega o recurso como um String a partir do URI especificado como uma operação assíncrona usando um objeto tarefa. |
| DownloadStringTaskAsync(Uri) |
Descarrega o recurso como um String a partir do URI especificado como uma operação assíncrona usando um objeto tarefa. |
DownloadStringTaskAsync(String)
Descarrega o recurso como um String a partir do URI especificado como uma operação assíncrona usando um objeto tarefa.
public:
System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(System::String ^ address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync(string address);public System.Threading.Tasks.Task<string> DownloadStringTaskAsync(string address);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>member this.DownloadStringTaskAsync : string -> System.Threading.Tasks.Task<string>Public Function DownloadStringTaskAsync (address As String) As Task(Of String)Parâmetros
- address
- String
O URI do recurso a descarregar.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um Byte array contendo o recurso descarregado.
- Atributos
Exceções
O address parâmetro é null.
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
Ocorreu um erro durante o download do recurso.
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 após o download do recurso de dados. O recurso é descarregado de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads.
Após descarregar o recurso, este método utiliza a codificação especificada na Encoding propriedade para converter o recurso num String. Este método não bloqueia o fio de chamada durante o download do recurso.
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 contiver um URI absoluto, address deve ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia vazia, é 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.
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.
Aplica-se a
DownloadStringTaskAsync(Uri)
Descarrega o recurso como um String a partir do URI especificado como uma operação assíncrona usando um objeto tarefa.
public:
System::Threading::Tasks::Task<System::String ^> ^ DownloadStringTaskAsync(Uri ^ address);[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task<string> DownloadStringTaskAsync(Uri address);public System.Threading.Tasks.Task<string> DownloadStringTaskAsync(Uri address);[<System.Runtime.InteropServices.ComVisible(false)>]
member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>member this.DownloadStringTaskAsync : Uri -> System.Threading.Tasks.Task<string>Public Function DownloadStringTaskAsync (address As Uri) As Task(Of String)Parâmetros
- address
- Uri
O URI do recurso a descarregar.
Devoluções
O objeto tarefa que representa a operação assíncrona. A Result propriedade no objeto tarefa devolve um Byte array contendo o recurso descarregado.
- Atributos
Exceções
O address parâmetro é null.
O URI formado pela combinação BaseAddress de e address é inválido.
-ou-
Ocorreu um erro durante o download do recurso.
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 após o download do recurso de dados. O recurso é descarregado de forma assíncrona usando recursos de thread que são automaticamente alocados a partir do pool de threads.
Após descarregar o recurso, este método utiliza a codificação especificada na Encoding propriedade para converter o recurso num String. Este método não bloqueia o fio de chamada durante o download do recurso.
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 contiver um URI absoluto, address deve ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a QueryString propriedade não for uma cadeia vazia, é 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.
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.