Procedura: scaricare file in Visual Basic

Articolo
09/12/2008

Aggiornamento: novembre 2007

Per scaricare un file remoto e archiviarlo in un percorso specifico è possibile utilizzare Metodo My.Computer.Network.DownloadFile. Se il parametro ShowUI è impostato su True, verrà visualizzata una finestra di dialogo in cui viene illustrato lo stato di avanzamento del processo di download e che consente di annullare l'operazione. Per impostazione predefinita, i file esistenti con lo stesso nome non vengono sovrascritti. Se si desidera sovrascrivere i file esistenti, impostare il parametro overwrite su True.

Le seguenti condizioni possono generare un'eccezione:

Il nome dell'unità non è valido (ArgumentException).
Non è stata fornita l'autenticazione necessaria (UnauthorizedAccessException o SecurityException).
Il server non risponde entro il connectionTimeout specificato (TimeoutException).
Il sito web ha rifiutato la richiesta (WebException).

Nota:
Le opzioni disponibili nelle finestre di dialogo, nonché i nomi e le posizioni dei comandi di menu, possono non corrispondere a quanto descritto nella Guida poiché dipendono dalle impostazioni attive o dall'edizione in uso. Questo argomento della Guida è stato creato basandosi su Impostazioni generali per lo sviluppo. Per modificare le impostazioni, scegliere Importa/Esporta impostazioni dal menu Strumenti. Per ulteriori informazioni, vedere Impostazioni di Visual Studio.

Le opzioni disponibili nelle finestre di dialogo, nonché i nomi e le posizioni dei comandi di menu, possono non corrispondere a quanto descritto nella Guida poiché dipendono dalle impostazioni attive o dall'edizione in uso. Questo argomento della Guida è stato creato basandosi su Impostazioni generali per lo sviluppo. Per modificare le impostazioni, scegliere Importa/Esporta impostazioni dal menu Strumenti. Per ulteriori informazioni, vedere Impostazioni di Visual Studio.

Nota sulla sicurezza:
Non basarsi sul nome del file per prendere decisioni in merito al relativo contenuto. È possibile ad esempio che il file Form1.vb non sia un file di origine di Visual Basic. Prima di utilizzare i dati dell'applicazione, verificare tutti gli input. È possibile che il contenuto del file non corrisponda a quanto previsto e che quindi i metodi per la lettura dal file non abbiano esito positivo.

Per scaricare un file

Utilizzare il metodo DownloadFile per scaricare il file, specificando il percorso del file di destinazione come una stringa o URI e specificando il percorso dove archiviare il file. Nell'esempio riportato di seguito viene eseguito il download del file WineList.txt da http://www.cohowinery.com/downloads e viene salvato in C:\Documents and Settings\All Users\Documents:
```
My.Computer.Network.DownloadFile _
    ("http://www.cohowinery.com/downloads/WineList.txt", _
    "C:\Documents and Settings\All Users\Documents\WineList.txt")
```

Per scaricare un file, specificando un intervallo di timeout

Utilizzare il metodo DownloadFile per eseguire il download del file, specificando il percorso del file di destinazione come una stringa o URI, il percorso dove archiviare il file e l'intervallo di timeout in millisecondi. Il valore predefinito di è 1000. Nell'esempio riportato di seguito viene eseguito il download del file WineList.txt da http://www.cohowinery.com/downloads e viene salvato in C:\Documents and Settings\All Users\Documents, specificando un intervallo di timeout di 500 millisecondi:
```
My.Computer.Network.DownloadFile _
    ("http://www.cohowinery.com/downloads/WineList.txt", _
    "C:\Documents and Settings\All Users\Documents\WineList.txt", False, 500)
```

Per scaricare un file, fornendo un nome utente e una password

Utilizzare il metodo DownLoadFile per eseguire il download del file, specificando il percorso del file di destinazione come una stringa o URI e il percorso dove archiviare il file, il nome utente e la password. Nell'esempio riportato di seguito viene eseguito il download del file WineList.txt da http://www.cohowinery.com/downloads e viene salvato in C:\Documents and Settings\All Users\Documents, con il nome utente anonymous e una password vuota.

My.Computer.Network.DownloadFile _
    ("http://www.cohowinery.com/downloads/WineList.txt", _
    "C:\Documents and Settings\All Users\Documents\WineList.txt", "anonymous", "")

Nota sulla sicurezza:
Il protocollo FTP utilizzato dal metodo DownLoadFile invia informazioni, comprese le password, in testo semplice e non deve pertanto essere utilizzato per la trasmissione di informazioni riservate.