Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo WebClient.DownloadFile (String, String)

 

Data di pubblicazione: ottobre 2016

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

Spazio dei nomi:   System.Net
Assembly:  System (in System.dll)

public void DownloadFile(
	string address,
	string fileName
)

Parametri

address
Type: System.String

L'URI da cui scaricare i dati.

fileName
Type: System.String

Il nome del file locale che riceverà i dati.

Exception Condition
ArgumentNullException

Il valore del parametro address è null.

WebException

L'URI formato dalla combinazione 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

Il metodo è stato chiamato simultaneamente su più thread.

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

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

Questo metodo utilizza il comando RETR per scaricare una risorsa FTP. Per una risorsa HTTP viene utilizzato il metodo GET.

System_CAPS_noteNota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Tracciatura di rete in .NET Framework.

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

Esempio di codice seguente scarica un file da http://www.contoso.com sul disco rigido locale.

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

FileIOPermission

to write the file fileName. Associated enumeration: F:System.Security.Permissions.FileIOPermissionAccess.Write.

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: