WebClient.DownloadFile Método

Definição

Namespace:

System.Net

Assembly:

System.Net.WebClient.dll

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

Sobrecargas

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

DownloadFile(Uri, String)

Origem:

WebClient.cs

Baixa o recurso com o URI especificado para 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 -

Ocorreu um erro ao baixar os dados.

NotSupportedException

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

Comentários

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

Se a BaseAddress propriedade 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 QueryString propriedade 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.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede em .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 para 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 os dados serão baixados.

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- Erro ao baixar os 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

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

Se a BaseAddress propriedade 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 QueryString propriedade 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.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de rede em .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.