WebClient.DownloadFile Método

Origem:

WebClient.cs

Origem:

WebClient.cs

Origem:

WebClient.cs

Origem:

WebClient.cs

Origem:

WebClient.cs

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

Exceções

Observações

O DownloadFile método descarrega para um ficheiro local os dados do URI especificado por no address parâmetro. Este método bloqueia durante o download do recurso. Para descarregar um recurso e continuar a executar enquanto espera pela resposta do servidor, use um dos DownloadFileAsync métodos.

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.

Ao usar este método numa aplicação de nível intermédio, como uma página ASP.NET, receberá um erro se a conta sob a qual a aplicação é executada não tiver permissão para aceder ao ficheiro.

Origem:

WebClient.cs

Origem:

WebClient.cs

Origem:

WebClient.cs

Origem:

WebClient.cs

Origem:

WebClient.cs

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

Exceções

Exemplos

O seguinte exemplo de código descarrega um ficheiro para http://www.contoso.com 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))

Observações

O DownloadFile método descarrega para um ficheiro local os dados do URI especificado por no address parâmetro. Este método bloqueia durante o download do recurso. Para descarregar um recurso e continuar a executar enquanto espera pela resposta do servidor, use um dos DownloadFileAsync métodos.

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.

Ao usar este método numa aplicação de nível intermédio, como uma página ASP.NET, receberá um erro se a conta sob a qual a aplicação é executada não tiver permissão para aceder ao ficheiro.