Condividi tramite

Metodo My.Computer.Network.DownloadFile

  • Articolo

Aggiornamento: novembre 2007

Consente di scaricare il file remoto specificato e lo salva nel percorso specificato.

' Usage
My.Computer.Network.DownloadFile(address ,destinationFileName)
My.Computer.Network.DownloadFile(address ,destinationFileName)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password ,showUI ,connectionTimeout ,overwrite)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password ,showUI ,connectionTimeout ,overwrite ,onUserCancel)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password ,showUI ,connectionTimeout ,overwrite)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password ,showUI ,connectionTimeout ,overwrite ,onUserCancel)
My.Computer.Network.DownloadFile(address ,destinationFileName ,networkCredentials ,showUI ,connectionTimeout ,overwrite)
My.Computer.Network.DownloadFile(address ,destinationFileName ,networkCredentials ,showUI ,connectionTimeout ,overwrite ,onUserCancel)
' Declaration
Public Sub DownloadFile( _
   ByVal address As String, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As String, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As String, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As String, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean, _
   ByVal onUserCancel As UICancelOption _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean, _
   ByVal onUserCancel As UICancelOption _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal networkCredentials As System.Net.ICredentials, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal networkCredentials As System.Net.ICredentials, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean, _
   ByVal onUserCancel As UICancelOption _
)

Parametri

  • address
    String o Uri. Percorso del file da scaricare, compreso il nome di file e l'indirizzo host. Obbligatorio.

  • destinationFileName
    String. Nome di file e percorso del file scaricato. Obbligatorio.

  • userName
    String. Nome utente da autenticare. Il valore predefinito è una stringa vuota: "".

  • password
    String. Password da autenticare. Il valore predefinito è una stringa vuota: "".

  • showUI
    Boolean. Specifica se visualizzare o meno lo stato dell'operazione. Il valore predefinito è False.

  • connectionTimeout
    Int32. Intervallo di timeout in millisecondi. Il valore predefinito è 100 secondi.

  • overwrite
    Boolean. Specifica se sovrascrivere i file esistenti. Il valore predefinito è False.

  • onUserCancel
    UICancelOption. Specifica il comportamento dopo che l'utente ha scelto Annulla o No dalla finestra di dialogo visualizzata come risultato di ShowUI impostato su True. Il valore predefinito è ThrowException.

  • networkCredentials
    ICredentials. Credenziali da fornire.

Eccezioni

Le seguenti condizioni possono causare la generazione di un'eccezione:

Note

Se showUI è impostato su True, viene visualizzata una finestra di dialogo che visualizza lo stato dell'operazione. La finestra di dialogo contiene un pulsante Annulla che può essere utilizzato per annullare l'operazione. La finestra di dialogo non è modale e quindi non blocca l'input dell'utente nelle altre finestre del programma.

Se il server non risponde entro il connectionTimeout specificato, l'operazione sarà annullata e verrà generata un'eccezione.

Quando si abilita l'analisi di rete nell'applicazione, DownloadFile genera informazioni di analisi. Per ulteriori informazioni, vedere Enabling Network Tracing.

Nota:

Il metodo DownloadFile non invia intestazioni HTTP facoltative. Alcuni server potrebbero restituire l'errore 500 (errore interno del server) se manca l'intestazione facoltativa dell'agente utente. Per inviare intestazioni facoltative, è necessario creare una richiesta tramite la classe WebClient. Per ulteriori informazioni, vedere Operazioni di rete in .NET Framework con Visual Basic.
Nota sulla sicurezza:

Il protocollo FTP invia informazioni, comprese le password in testo semplice e non dovrebbe essere utilizzato per la trasmissione di informazioni riservate.

Attività

Nella tabella riportata di seguito viene elencato un esempio di un'attività relativa al metodo My.Computer.Network.DownloadFile.

Per

Vedere

Scaricare un file

Procedura: scaricare file in Visual Basic

Esempio

Nell'esempio riportato di seguito il file WineList.txt viene scaricato 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")

Nell'esempio riportato di seguito il file WineList.txt viene scaricato 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/", _
"C:\Documents and Settings\All Users\Documents\WineList.txt", _
"", "", False, 500, True)

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.Devices

Classe:Network

Assembly: la libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità in base al tipo di progetto

Tipo di progetto

Disponibile

Applicazione Windows

Sì

Libreria di classi

Sì

Applicazione di console

Sì

Libreria di controlli Windows

Sì

Libreria di controllo Web

Sì

Servizio Windows

Sì

Sito Web

Sì

Autorizzazioni

Potrebbero essere necessarie le autorizzazioni riportate di seguito:

Autorizzazione

Descrizione

FileIOPermission

Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted.

UIPermission

Consente di controllare le autorizzazioni correlate alle interfacce utente e gli Appunti. Enumerazione associata: AllWindows.

WebPermission

Consente di controllare i diritti di accesso alle risorse Internet HTTP. Enumerazione associata: Unrestricted.

Per ulteriori informazioni, vedere Protezione dall'accesso di codice e Richiesta di autorizzazioni.

Vedere anche

Attività

Procedura: scaricare file in Visual Basic

Procedura: determinare la disponibilità di un computer remoto in Visual Basic

Procedura: analizzare percorsi di file in Visual Basic

Riferimenti

Oggetto My.Computer.Network

System.Uri

System.Net.ICredentials

Network.DownloadFile