Condividi tramite

WebClient.DownloadFile Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Net
Assembly:
System.Net.WebClient.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Scarica la risorsa con l'URI specificato in un file locale.

Overload

DownloadFile(Uri, String)

Scarica la risorsa con l'URI specificato in un file locale.
DownloadFile(String, String)

Scarica la risorsa con l'URI specificato in un file locale.

DownloadFile(Uri, String)

Origine:
WebClient.cs
Origine:
WebClient.cs
Origine:
WebClient.cs

Scarica la risorsa con l'URI specificato in un file locale.

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)

Parametri

address
Uri

URI specificato come String, da cui scaricare i dati.

fileName
String

Nome del file locale che deve ricevere i dati.

Eccezioni

ArgumentNullException

Il parametro address è null.

-o-

Il parametro fileName è null.

WebException

L'URI formato dalla combinazione di BaseAddress e address non è valido.

-o-

filename è null o Empty.

-o-

Il file non esiste.

-o-

Errore durante il download dei dati.

NotSupportedException

Il metodo è stato chiamato simultaneamente su più thread.

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Il metodo DownloadFile scarica in un file locale i dati dall'URI specificato da nel parametro address. Questo metodo si blocca durante il download della risorsa. Per scaricare una risorsa e continuare l'esecuzione durante l'attesa della risposta del server, usare uno dei metodi di DownloadFileAsync.

Se la proprietà BaseAddress non è una stringa vuota ("") e address non contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se la proprietà QueryString non è una stringa vuota, viene aggiunta a address.

Questo metodo usa il comando RETR per scaricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo GET.

Nota

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Quando si usa questo metodo in un'applicazione di livello intermedio, ad esempio una pagina di ASP.NET, si riceverà un errore se l'account in cui viene eseguita l'applicazione non dispone dell'autorizzazione per accedere al file.

Si applica a

DownloadFile(String, String)

Origine:
WebClient.cs
Origine:
WebClient.cs
Origine:
WebClient.cs

Scarica la risorsa con l'URI specificato in un file locale.

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)

Parametri

address
String

URI da cui scaricare i dati.

fileName
String

Nome del file locale che deve ricevere i dati.

Eccezioni

ArgumentNullException

Il parametro address è null.

WebException

L'URI formato dalla combinazione di BaseAddress e address non è valido.

-o-

filename è null o Empty.

-o-

Il file non esiste.

-oppure- Si è verificato un errore durante il download dei dati.

NotSupportedException

Il metodo è stato chiamato simultaneamente su più thread.

Esempio

L'esempio di codice seguente scarica un file da http://www.contoso.com nel disco rigido locale.

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))

Commenti

Cautela

WebRequest, HttpWebRequest, ServicePointe WebClient sono obsoleti e non è consigliabile usarli per nuovi sviluppi. Usare invece HttpClient.

Il metodo DownloadFile scarica in un file locale i dati dall'URI specificato da nel parametro address. Questo metodo si blocca durante il download della risorsa. Per scaricare una risorsa e continuare l'esecuzione durante l'attesa della risposta del server, usare uno dei metodi di DownloadFileAsync.

Se la proprietà BaseAddress non è una stringa vuota ("") e address non contiene un URI assoluto, address deve essere un URI relativo combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se la proprietà QueryString non è una stringa vuota, viene aggiunta a address.

Questo metodo usa il comando RETR per scaricare una risorsa FTP. Per una risorsa HTTP, viene usato il metodo GET.

Nota

Questo membro restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Traccia di rete in .NET Framework.

Quando si usa questo metodo in un'applicazione di livello intermedio, ad esempio una pagina di ASP.NET, si riceverà un errore se l'account in cui viene eseguita l'applicazione non dispone dell'autorizzazione per accedere al file.

Si applica a