Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método WebClient.DownloadStringAsync (Uri, Object)

 

Downloads da cadeia especificada para o recurso especificado. Esse método não bloqueia o thread de chamada.

Namespace:   System.Net
Assembly:  System (em System.dll)

[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)]
public void DownloadStringAsync(
	Uri address,
	object userToken
)

Parâmetros

address
Type: System.Uri

Um Uri que contém o URI para fazer o download.

userToken
Type: System.Object

Um objeto definido pelo usuário que é passado para o método chamado quando a operação assíncrona for concluída.

Exception Condition
ArgumentNullException

O address parâmetro é null.

WebException

O URI é formada combinando BaseAddress e address é inválido.

- ou -

Ocorreu um erro ao baixar o recurso.

O recurso é baixado de forma assíncrona usando os recursos de thread são alocados automaticamente do pool de threads.

Depois de baixar o recurso, esse método usa a codificação especificada no Encoding propriedade para converter o recurso a um String. Esse método não bloqueia o thread de chamada durante o download do recurso. Para baixar um recurso e o bloco enquanto aguarda a resposta do servidor, use o DownloadString método. Quando o download for concluído, o DownloadStringCompleted é gerado. Seu aplicativo deve tratar esse evento para receber uma notificação. A cadeia de caracteres baixada está disponível na Result propriedade.

Você pode usar o CancelAsync método cancelar operações assíncronas que não foram concluídas.

Se o BaseAddress propriedade não é uma cadeia de caracteres vazia ("") e address não contém um URI absoluto, address deve ser um URI relativo é combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se o QueryString não é uma cadeia de caracteres vazia, ele é acrescentado à address.

Esse método usa o comando RETR para baixar um recurso FTP. Para um recurso HTTP, é usado o método GET.

System_CAPS_noteObservação

Esse membro gera informações de rastreamento, quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede no .NET Framework.

.NET Framework
Disponível desde 2.0
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Retornar ao início
Mostrar: