Network.DownloadFile Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.VisualBasic.Devices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.

Overload

DownloadFile(String, String)	Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.
DownloadFile(Uri, String)	Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.
DownloadFile(String, String, String, String)	Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.
DownloadFile(Uri, String, String, String)	Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)	Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean)	Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)	Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)	Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.

DownloadFile(String, String)

Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName);

public void DownloadFile (string address, string destinationFileName);

member this.DownloadFile : string * string -> unit

Public Sub DownloadFile (address As String, destinationFileName As String)

Parametri

address: String

Percorso del file da scaricare, inclusi il nome di file e l'indirizzo host.

destinationFileName: String

Nome e percorso del file scaricato.

Eccezioni

ArgumentException

destinationFileName termina con una barra finale.

TimeoutException

Il server non risponde entro il timeout predefinito (100 secondi).

SecurityException

L'utente non dispone delle autorizzazioni necessarie per eseguire un'operazione di rete.

WebException

Il sito Web di destinazione ha rifiutato la richiesta.

Esempio

Questo esempio scarica il file WineList.txt da http://www.cohowinery.com/downloads e lo salva 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")

In questo esempio il file WineList.txt viene http://www.cohowinery.com/downloads scaricato e 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)

Commenti

DownloadFile restituisce le informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Abilitazione della traccia di rete.

Nota

Il DownloadFile metodo non invia intestazioni HTTP facoltative. Alcuni server potrebbero restituire 500 (errore interno del server) se l'intestazione facoltativa dell'agente utente non è presente. Per inviare intestazioni facoltative, è necessario costruire una richiesta usando la WebClient classe .

La tabella seguente elenca un esempio di un'attività che coinvolge il My.Computer.Network.DownloadFile metodo .

A	Vedere
Scaricare un file	Procedura: Scaricare un file

Vedi anche

Si applica a

DownloadFile(Uri, String)

Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName);

public void DownloadFile (Uri address, string destinationFileName);

member this.DownloadFile : Uri * string -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String)

Parametri

address: Uri

Percorso del file da scaricare, inclusi il nome di file e l'indirizzo host.

destinationFileName: String

Nome e percorso del file scaricato.

Eccezioni

ArgumentException

destinationFileName termina con una barra finale.

TimeoutException

Il server non risponde entro il timeout predefinito (100 secondi).

SecurityException

L'utente non dispone delle autorizzazioni necessarie per eseguire un'operazione di rete.

WebException

Il sito Web di destinazione ha rifiutato la richiesta.

Esempio

Questo esempio scarica il file WineList.txt da http://www.cohowinery.com/downloads e lo salva 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")

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

Commenti

Se il file di destinazione esiste già, il DownloadFile metodo non sovrascriverà il file esistente. È possibile usare uno degli altri overload del DownloadFile metodo per indicare che sovrascrive i file esistenti, specificare le credenziali utente o specificare un valore di timeout specifico. DownloadFile restituisce le informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Abilitazione della traccia di rete.

Nota

La tabella seguente elenca un esempio di un'attività che coinvolge il My.Computer.Network.DownloadFile metodo .

A	Vedere
Scaricare un file	Procedura: Scaricare un file

Vedi anche

Si applica a

DownloadFile(String, String, String, String)

Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);

public void DownloadFile (string address, string destinationFileName, string userName, string password);

member this.DownloadFile : string * string * string * string -> unit

Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String)

Parametri

address: String

Percorso del file da scaricare, inclusi il nome di file e l'indirizzo host.

destinationFileName: String

Nome e percorso del file scaricato.

userName: String

Nome utente da autenticare. Il valore predefinito è una stringa vuota. "".

password: String

Password da autenticare. Il valore predefinito è una stringa vuota. "".

Eccezioni

ArgumentException

destinationFileName termina con una barra finale.

TimeoutException

Il server non risponde entro il timeout predefinito (100 secondi).

SecurityException

L'utente non dispone delle autorizzazioni necessarie per eseguire un'operazione di rete.

WebException

Il sito Web di destinazione ha rifiutato la richiesta.

Esempio

Questo esempio scarica il file WineList.txt da http://www.cohowinery.com/downloads e lo salva 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")

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

Commenti

DownloadFile restituisce le informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Abilitazione della traccia di rete.

Nota

Il protocollo FTP invia informazioni, incluse le password, nel testo normale e non deve essere usata per trasmettere informazioni sensibili.

La tabella seguente elenca un esempio di un'attività che coinvolge il My.Computer.Network.DownloadFile metodo .

A	Vedere
Scaricare un file	Procedura: Scaricare un file

Vedi anche

Si applica a

DownloadFile(Uri, String, String, String)

Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);

public void DownloadFile (Uri address, string destinationFileName, string userName, string password);

member this.DownloadFile : Uri * string * string * string -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String)

Parametri

address: Uri

Percorso del file da scaricare, inclusi il nome di file e l'indirizzo host.

destinationFileName: String

Nome e percorso del file scaricato.

userName: String

Nome utente da autenticare. Il valore predefinito è una stringa vuota. "".

password: String

Password da autenticare. Il valore predefinito è una stringa vuota. "".

Eccezioni

ArgumentException

destinationFileName termina con una barra finale.

TimeoutException

Il server non risponde entro il timeout predefinito (100 secondi).

SecurityException

L'utente non dispone delle autorizzazioni necessarie per eseguire un'operazione di rete.

WebException

Il sito Web di destinazione ha rifiutato la richiesta.

Esempio

Questo esempio scarica il file WineList.txt da http://www.cohowinery.com/downloads e lo salva 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")

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

Commenti

DownloadFile restituisce le informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Abilitazione della traccia di rete.

Nota

Il protocollo FTP invia informazioni, incluse le password, nel testo normale e non deve essere usata per trasmettere informazioni sensibili.

La tabella seguente elenca un esempio di un'attività che coinvolge il My.Computer.Network.DownloadFile metodo .

A	Vedere
Scaricare un file	Procedura: Scaricare un file

Vedi anche

Si applica a

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)

Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite);

public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite);

member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

Parametri

address: Uri

String o Uri. Percorso del file da scaricare, inclusi il nome di file e l'indirizzo host.

destinationFileName: String

String. Nome e percorso del file scaricato.

networkCredentials: ICredentials

ICredentials. Credenziali da fornire.

showUI: Boolean

True per visualizzare lo stato dell'operazione; in caso contrario, False. Il valore predefinito è False.

connectionTimeout: Int32

Intervallo di timeout, in millisecondi. Il valore predefinito è 100 secondi.

overwrite: Boolean

True per sovrascrivere i file esistenti; in caso contrario, False. Il valore predefinito è False.

Eccezioni

ArgumentException

destinationFileName termina con una barra finale.

IOException

overwrite è impostato su False e il file di destinazione esiste già.

TimeoutException

Il server non risponde entro il connectionTimeout specificato.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per eseguire un'operazione di rete.

WebException

Il sito Web di destinazione ha rifiutato la richiesta.

Esempio

Questo esempio scarica il file WineList.txt da http://www.cohowinery.com/downloads e lo salva 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")

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

Commenti

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

Se il server non risponde all'interno dell'oggetto specificato connectionTimeout, l'operazione viene annullata e viene generata un'eccezione.

DownloadFile restituisce le informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Abilitazione della traccia di rete.

Nota

Il protocollo FTP invia informazioni, incluse le password, nel testo normale e non deve essere usata per trasmettere informazioni sensibili.

La tabella seguente elenca un esempio di un'attività che coinvolge il My.Computer.Network.DownloadFile metodo .

A	Vedere
Scaricare un file	Procedura: Scaricare un file

Vedi anche

Si applica a

DownloadFile(String, String, String, String, Boolean, Int32, Boolean)

Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);

public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);

member this.DownloadFile : string * string * string * string * bool * int * bool -> unit

Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

Parametri

address: String

Percorso del file da scaricare, inclusi il nome di file e l'indirizzo host.

destinationFileName: String

Nome e percorso del file scaricato.

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

True per visualizzare lo stato dell'operazione; in caso contrario, False. Il valore predefinito è False.

connectionTimeout: Int32

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

overwrite: Boolean

True per sovrascrivere i file esistenti; in caso contrario, False. Il valore predefinito è False.

Eccezioni

ArgumentException

destinationFileName termina con una barra finale.

IOException

overwrite è impostato su False e il file di destinazione esiste già.

TimeoutException

Il server non risponde entro il connectionTimeout specificato.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per eseguire un'operazione di rete.

WebException

Il sito Web di destinazione ha rifiutato la richiesta.

Esempio

Questo esempio scarica il file WineList.txt da http://www.cohowinery.com/downloads e lo salva 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")

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

Commenti

Se il server non risponde all'interno dell'oggetto specificato connectionTimeout, l'operazione viene annullata e viene generata un'eccezione.

DownloadFile restituisce le informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Abilitazione della traccia di rete.

Nota

Il protocollo FTP invia informazioni, incluse le password, in testo normale e non devono essere usate per la trasmissione di informazioni riservate.

Nella tabella seguente è riportato un esempio di attività che include il My.Computer.Network.DownloadFile metodo .

A	Vedere
Scaricare un file	Procedura: Scaricare un file

Vedi anche

Si applica a

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)

Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

Parametri

address: Uri

Percorso del file da scaricare, inclusi il nome di file e l'indirizzo host.

destinationFileName: String

Nome e percorso del file scaricato.

networkCredentials: ICredentials

Credenziali da fornire.

showUI: Boolean

True per visualizzare lo stato dell'operazione; in caso contrario, False. Il valore predefinito è False.

connectionTimeout: Int32

Intervallo di timeout, in millisecondi. Il valore predefinito è 100 secondi.

overwrite: Boolean

True per sovrascrivere i file esistenti; in caso contrario, False. Il valore predefinito è False.

onUserCancel: UICancelOption

Specifica il comportamento quando l'utente fa clic su Annulla o No nella finestra di dialogo visualizzata se showUI è impostata su True. Il valore predefinito è ThrowException.

Eccezioni

ArgumentException

destinationFileName termina con una barra finale.

IOException

overwrite è impostato su False e il file di destinazione esiste già.

TimeoutException

Il server non risponde entro il connectionTimeout specificato.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per eseguire un'operazione di rete.

WebException

Il sito Web di destinazione ha rifiutato la richiesta.

Esempio

Questo esempio scarica il file WineList.txt da http://www.cohowinery.com/downloads e lo salva 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")

Questo esempio scarica il file WineList.txt da http://www.cohowinery.com/downloads e lo salva 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)

Commenti

Se showUI è impostato su True, viene visualizzata una finestra di dialogo che mostra lo stato di avanzamento 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 pertanto non blocca l'input dell'utente in altre finestre del programma.

Se il server non risponde all'interno dell'oggetto specificato connectionTimeout, l'operazione viene annullata e viene generata un'eccezione.

DownloadFile restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Abilitazione della traccia di rete.

Nota

Il DownloadFile metodo non invia intestazioni HTTP facoltative. Alcuni server potrebbero restituire 500 (errore interno del server) se manca l'intestazione facoltativa dell'agente utente. Per inviare intestazioni facoltative, è necessario costruire una richiesta usando la WebClient classe .

Nota

Il protocollo FTP invia informazioni, incluse le password, in testo normale e non devono essere usate per la trasmissione di informazioni riservate.

Nella tabella seguente è riportato un esempio di attività che include il My.Computer.Network.DownloadFile metodo .

A	Vedere
Scaricare un file	Procedura: Scaricare un file

Vedi anche

Si applica a

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)

Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);

public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);

member this.DownloadFile : Uri * string * string * string * bool * int * bool -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

Parametri

address: Uri

Percorso del file da scaricare, inclusi il nome di file e l'indirizzo host.

destinationFileName: String

Nome e percorso del file scaricato.

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

True per visualizzare lo stato dell'operazione; in caso contrario, False. Il valore predefinito è False.

connectionTimeout: Int32

Intervallo di timeout, in millisecondi. Il valore predefinito è 100 secondi.

overwrite: Boolean

True per sovrascrivere i file esistenti; in caso contrario, False. Il valore predefinito è False.

Eccezioni

ArgumentException

destinationFileName termina con una barra finale.

IOException

overwrite è impostato su False e il file di destinazione esiste già.

TimeoutException

Il server non risponde entro il connectionTimeout specificato.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per eseguire un'operazione di rete.

WebException

Il sito Web di destinazione ha rifiutato la richiesta.

Esempio

Questo esempio scarica il file WineList.txt da http://www.cohowinery.com/downloads e lo salva 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")

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

Commenti

Se showUI è impostato su True, viene visualizzata una finestra di dialogo che mostra lo stato di avanzamento 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 pertanto non blocca l'input dell'utente in altre finestre del programma.

Se il server non risponde all'interno dell'oggetto specificato connectionTimeout, l'operazione viene annullata e viene generata un'eccezione.

DownloadFile restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Abilitazione della traccia di rete.

Nota

Il protocollo FTP invia informazioni, incluse le password, in testo normale e non devono essere usate per la trasmissione di informazioni riservate.

Nella tabella seguente è riportato un esempio di attività che include il My.Computer.Network.DownloadFile metodo .

A	Vedere
Scaricare un file	Procedura: Scaricare un file

Vedi anche

Si applica a

DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DownloadFile : string * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

Parametri

address: String

Percorso del file da scaricare, inclusi il nome di file e l'indirizzo host.

destinationFileName: String

Nome e percorso del file scaricato.

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

True per visualizzare lo stato dell'operazione; in caso contrario, False. Il valore predefinito è False.

connectionTimeout: Int32

Intervallo di timeout, in millisecondi. Il valore predefinito è 100 secondi.

overwrite: Boolean

True per sovrascrivere i file esistenti; in caso contrario, False. Il valore predefinito è False.

onUserCancel: UICancelOption

Specifica il comportamento quando l'utente fa clic su Annulla o No nella finestra di dialogo visualizzata se ShowUI è impostata su True. Il valore predefinito è ThrowException.

Eccezioni

ArgumentException

destinationFileName termina con una barra finale.

IOException

overwrite è impostato su False e il file di destinazione esiste già.

TimeoutException

Il server non risponde entro il connectionTimeout specificato.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per eseguire un'operazione di rete.

WebException

Il sito Web di destinazione ha rifiutato la richiesta.

Esempio

Questo esempio scarica il file WineList.txt da http://www.cohowinery.com/downloads e lo salva 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")

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

Commenti

Se showUI è impostato su True, viene visualizzata una finestra di dialogo che mostra lo stato di avanzamento 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 pertanto non blocca l'input dell'utente in altre finestre del programma.

Se il server non risponde all'interno dell'oggetto specificato connectionTimeout, l'operazione viene annullata e viene generata un'eccezione.

DownloadFile restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Abilitazione della traccia di rete.

Nota

Il protocollo FTP invia informazioni, incluse le password, in testo normale e non devono essere usate per la trasmissione di informazioni riservate.

Nella tabella seguente è riportato un esempio di attività che include il My.Computer.Network.DownloadFile metodo .

A	Vedere
Scaricare un file	Procedura: Scaricare un file

Vedi anche

Si applica a

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Consente di scaricare il file remoto specificato e di salvarlo nel percorso specificato.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DownloadFile : Uri * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

Parametri

address: Uri

Percorso del file da scaricare, inclusi il nome di file e l'indirizzo host.

destinationFileName: String

Nome e percorso del file scaricato.

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

True per visualizzare lo stato dell'operazione; in caso contrario, False. Il valore predefinito è False.

connectionTimeout: Int32

Intervallo di timeout, in millisecondi. Il valore predefinito è 100 secondi.

overwrite: Boolean

True per sovrascrivere i file esistenti; in caso contrario, False. Il valore predefinito è False.

onUserCancel: UICancelOption

Specifica il comportamento quando l'utente fa clic su Annulla o No nella finestra di dialogo visualizzata se ShowUI è impostata su True. Il valore predefinito è ThrowException.

Eccezioni

ArgumentException

destinationFileName termina con una barra finale.

IOException

overwrite è impostato su False e il file di destinazione esiste già.

TimeoutException

Il server non risponde entro il connectionTimeout specificato.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per eseguire un'operazione di rete.

WebException

Il sito Web di destinazione ha rifiutato la richiesta.

Esempio

Questo esempio scarica il file WineList.txt da http://www.cohowinery.com/downloads e lo salva 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")

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

Commenti

Se showUI è impostato su True, viene visualizzata una finestra di dialogo che mostra lo stato di avanzamento 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 pertanto non blocca l'input dell'utente in altre finestre del programma.

Se il server non risponde all'interno dell'oggetto specificato connectionTimeout, l'operazione viene annullata e viene generata un'eccezione.

DownloadFile restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Abilitazione della traccia di rete.

Nota

Il protocollo FTP invia informazioni, incluse le password, in testo normale e non devono essere usate per la trasmissione di informazioni riservate.

Nella tabella seguente è riportato un esempio di attività che include il My.Computer.Network.DownloadFile metodo .

A	Vedere
Scaricare un file	Procedura: Scaricare un file

Vedi anche

Si applica a

Condividi tramite

Network.DownloadFile Metodo

Definizione

Overload

DownloadFile(String, String)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

DownloadFile(Uri, String)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

DownloadFile(String, String, String, String)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

DownloadFile(Uri, String, String, String)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

DownloadFile(String, String, String, String, Boolean, Int32, Boolean)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Risorse aggiuntive