WebClient.DownloadFile Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.WebClient.dll

Esegue il download, su un file locale, della risorsa con l'URI specificato.

Overload

DownloadFile(Uri, String)	Esegue il download, su un file locale, della risorsa con l'URI specificato.
DownloadFile(String, String)	Esegue il download, su un file locale, della risorsa con l'URI specificato.

DownloadFile(Uri, String)

Source:

WebClient.cs

Esegue il download, su un file locale, della risorsa con l'URI specificato.

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

L'URI specificato come classe String da cui eseguire il download dei dati.

fileName

String

Il nome del file locale per ricevere i dati.

Eccezioni

ArgumentNullException

Il valore del parametro address è null.

-oppure-

Il valore del parametro fileName è null.

WebException

L'URI ottenuto combinando BaseAddress e address non è valido.

-oppure-

filename è null o Empty.

-oppure-

Il file specificato non esiste.

-oppure-

Si è verificato un errore durante il download dei dati.

NotSupportedException

Questo metodo è stato chiamato simultaneamente su più thread.

Commenti

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

Se la BaseAddress proprietà 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 QueryString proprietà 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 genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. 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, verrà visualizzato un errore se l'account in cui l'applicazione viene eseguita non dispone dell'autorizzazione per accedere al file.

DownloadFile(String, String)

Source:

WebClient.cs

Esegue il download, su un file locale, della risorsa con l'URI specificato.

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

L'URI da cui eseguire il download dei dati.

fileName

String

Il nome del file locale per ricevere i dati.

Eccezioni

ArgumentNullException

Il valore del parametro address è null.

WebException

L'URI ottenuto combinando BaseAddress e address non è valido.

-oppure-

filename è null o Empty.

-oppure-

Il file specificato non esiste.

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

NotSupportedException

Questo metodo è stato chiamato simultaneamente su più thread.

Esempio

Nell'esempio di codice seguente viene scaricato un file dal http://www.contoso.com 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

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

Se la BaseAddress proprietà 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 QueryString proprietà 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 genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. 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, verrà visualizzato un errore se l'account in cui l'applicazione viene eseguita non dispone dell'autorizzazione per accedere al file.