WebClient.DownloadFile Método

Definição

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

Baixa o recurso com o URI especificado em um arquivo local.

Sobrecargas

DownloadFile(Uri, String)	Baixa o recurso com o URI especificado em um arquivo local.
DownloadFile(String, String)	Baixa o recurso com o URI especificado em um arquivo local.

DownloadFile(Uri, String)

Origem:

WebClient.cs

Baixa o recurso com o URI especificado em um arquivo local.

public:
 void DownloadFile(Uri ^ address, System::String ^ fileName);

public void DownloadFile (Uri address, string fileName);

member this.DownloadFile : Uri * string -> unit

Public Sub DownloadFile (address As Uri, fileName As String)

Parâmetros

address

Uri

O URI especificado como um String, do qual baixar dados.

fileName

String

O nome do arquivo local que deve receber os dados.

Exceções

ArgumentNullException

O parâmetro address é null.

-ou-

O parâmetro fileName é null.

WebException

O URI formado pela combinação de BaseAddress e address é inválido.

-ou-

filename é null ou Empty.

-ou-

O arquivo não existe.

-ou-

Erro ao baixar dados.

NotSupportedException

O método foi chamado simultaneamente em vários threads.

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

O método DownloadFile baixa para dados de arquivo local do URI especificado no parâmetro address. Esse método bloqueia ao baixar o recurso. Para baixar um recurso e continuar a execução enquanto aguarda a resposta do servidor, use um dos métodos DownloadFileAsync.

Se a propriedade BaseAddress não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a propriedade QueryString não for uma cadeia de caracteres vazia, ela será acrescentada a address.

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

Nota

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.

Ao usar esse método em um aplicativo de camada intermediária, como uma página ASP.NET, você receberá um erro se a conta na qual o aplicativo é executado não tiver permissão para acessar o arquivo.

DownloadFile(String, String)

Origem:

WebClient.cs

Baixa o recurso com o URI especificado em um arquivo local.

public:
 void DownloadFile(System::String ^ address, System::String ^ fileName);

public void DownloadFile (string address, string fileName);

member this.DownloadFile : string * string -> unit

Public Sub DownloadFile (address As String, fileName As String)

Parâmetros

address

String

O URI do qual baixar dados.

fileName

String

O nome do arquivo local que deve receber os dados.

Exceções

ArgumentNullException

O parâmetro address é null.

WebException

O URI formado pela combinação de BaseAddress e address é inválido.

-ou-

filename é null ou Empty.

-ou-

O arquivo não existe.

-ou- Ocorreu um erro ao baixar dados.

NotSupportedException

O método foi chamado simultaneamente em vários threads.

Exemplos

O exemplo de código a seguir baixa um arquivo de http://www.contoso.com para o disco rígido local.

String^ remoteUri = "http://www.contoso.com/library/homepage/images/";
String^ fileName = "ms-banner.gif", ^myStringWebResource = nullptr;
// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Concatenate the domain with the Web resource filename.
myStringWebResource = String::Concat( remoteUri, fileName );
Console::WriteLine( "Downloading File \"{0}\" from \"{1}\" .......\n\n", fileName, myStringWebResource );
// Download the Web resource and save it into the current filesystem folder.
myWebClient->DownloadFile( myStringWebResource, fileName );
Console::WriteLine( "Successfully Downloaded File \"{0}\" from \"{1}\"", fileName, myStringWebResource );
Console::WriteLine( "\nDownloaded file saved in the following file system folder:\n\t {0}", Application::StartupPath );

string remoteUri = "http://www.contoso.com/library/homepage/images/";
string fileName = "ms-banner.gif", myStringWebResource = null;
// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Concatenate the domain with the Web resource filename.
myStringWebResource = remoteUri + fileName;
Console.WriteLine("Downloading File \"{0}\" from \"{1}\" .......\n\n", fileName, myStringWebResource);
// Download the Web resource and save it into the current filesystem folder.
myWebClient.DownloadFile(myStringWebResource,fileName);		
Console.WriteLine("Successfully Downloaded File \"{0}\" from \"{1}\"", fileName, myStringWebResource);
Console.WriteLine("\nDownloaded file saved in the following file system folder:\n\t" + Application.StartupPath);

Dim remoteUri As String = "http://www.contoso.com/library/homepage/images/"
Dim fileName As String = "ms-banner.gif"
Dim myStringWebResource As String = Nothing
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Concatenate the domain with the Web resource filename. Because DownloadFile 
'requires a fully qualified resource name, concatenate the domain with the Web resource file name.
myStringWebResource = remoteUri + fileName
Console.WriteLine("Downloading File ""{0}"" from ""{1}"" ......." + ControlChars.Cr + ControlChars.Cr, fileName, myStringWebResource)
' The DownloadFile() method downloads the Web resource and saves it into the current file-system folder.
myWebClient.DownloadFile(myStringWebResource, fileName)
Console.WriteLine("Successfully Downloaded file ""{0}"" from ""{1}""", fileName, myStringWebResource)
Console.WriteLine((ControlChars.Cr + "Downloaded file saved in the following file system folder:" + ControlChars.Cr + ControlChars.Tab + Application.StartupPath))

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

O método DownloadFile baixa para dados de arquivo local do URI especificado no parâmetro address. Esse método bloqueia ao baixar o recurso. Para baixar um recurso e continuar a execução enquanto aguarda a resposta do servidor, use um dos métodos DownloadFileAsync.

Se a propriedade BaseAddress não for uma cadeia de caracteres vazia ("") e address não contiver um URI absoluto, address deverá ser um URI relativo combinado com BaseAddress para formar o URI absoluto dos dados solicitados. Se a propriedade QueryString não for uma cadeia de caracteres vazia, ela será acrescentada a address.

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

Nota

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.

Ao usar esse método em um aplicativo de camada intermediária, como uma página ASP.NET, você receberá um erro se a conta na qual o aplicativo é executado não tiver permissão para acessar o arquivo.