Network.DownloadFile Metodo

Definizione

Scarica il file remoto specificato e lo salva nel percorso specificato.

Overload

Nome Descrizione
DownloadFile(String, String)

Scarica il file remoto specificato e lo salva nel percorso specificato.

DownloadFile(Uri, String)

Scarica il file remoto specificato e lo salva nel percorso specificato.

DownloadFile(String, String, String, String)

Scarica il file remoto specificato e lo salva nel percorso specificato.

DownloadFile(Uri, String, String, String)

Scarica il file remoto specificato e lo salva nel percorso specificato.

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

Scarica il file remoto specificato e lo salva nel percorso specificato.

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

Scarica il file remoto specificato e lo salva nel percorso specificato.

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

Scarica il file remoto specificato e lo salva nel percorso specificato.

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

Scarica il file remoto specificato e lo salva nel percorso specificato.

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

Scarica il file remoto specificato e lo salva nel percorso specificato.

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

Scarica il file remoto specificato e lo salva nel percorso specificato.

DownloadFile(String, String)

Scarica il file remoto specificato e lo salva 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 file e l'indirizzo host.

destinationFileName
String

Nome e percorso del file scaricato.

Eccezioni

destinationFileName termina con una barra finale.

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

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

La richiesta viene negata dal server Web di destinazione.

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 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 al metodo di sovrascrivere i file esistenti, specificare le credenziali utente o specificare un valore di timeout specifico.

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

Note

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 .

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

Per Vedi
Scaricare un file Procedura: Scaricare un file

Vedi anche

Si applica a

DownloadFile(Uri, String)

Scarica il file remoto specificato e lo salva 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 file e l'indirizzo host.

destinationFileName
String

Nome e percorso del file scaricato.

Eccezioni

destinationFileName termina con una barra finale.

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

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

La richiesta viene negata dal server Web di destinazione.

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 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 al metodo di sovrascrivere i file esistenti, specificare le credenziali utente o specificare un valore di timeout specifico. DownloadFile restituisce informazioni di traccia quando si abilita la traccia di rete nell'applicazione. Per altre informazioni, vedere Abilitazione della traccia di rete.

Note

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 .

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

Per Vedi
Scaricare un file Procedura: Scaricare un file

Vedi anche

Si applica a

DownloadFile(String, String, String, String)

Scarica il file remoto specificato e lo salva 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 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 per l'autenticazione. Il valore predefinito è una stringa vuota, "".

Eccezioni

destinationFileName termina con una barra finale.

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

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

La richiesta viene negata dal server Web di destinazione.

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 il file di destinazione esiste già, il DownloadFile metodo non sovrascriverà il file esistente. È possibile utilizzare uno degli altri overload del DownloadFile metodo per indicare al metodo di sovrascrivere i file esistenti o specificare un valore di timeout specifico.

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

Note

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 .

Note

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 .

Per Vedi
Scaricare un file Procedura: Scaricare un file

Vedi anche

Si applica a

DownloadFile(Uri, String, String, String)

Scarica il file remoto specificato e lo salva 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 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 per l'autenticazione. Il valore predefinito è una stringa vuota, "".

Eccezioni

destinationFileName termina con una barra finale.

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

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

La richiesta viene negata dal server Web di destinazione.

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 il file di destinazione esiste già, il DownloadFile metodo non sovrascriverà il file esistente. È possibile utilizzare uno degli altri overload del DownloadFile metodo per indicare al metodo di sovrascrivere i file esistenti o specificare un valore di timeout specifico.

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

Note

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 .

Note

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 .

Per Vedi
Scaricare un file Procedura: Scaricare un file

Vedi anche

Si applica a

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

Scarica il file remoto specificato e lo salva 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 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, espresso in millisecondi. Il valore predefinito è 100 secondi.

overwrite
Boolean

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

Eccezioni

destinationFileName termina con una barra finale.

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

Il server non risponde all'interno dell'oggetto specificato connectionTimeout.

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

La richiesta viene negata dal server Web di destinazione.

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.

Note

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 .

Note

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 .

Per Vedi
Scaricare un file Procedura: Scaricare un file

Vedi anche

Si applica a

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

Scarica il file remoto specificato e lo salva 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 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 per l'autenticazione. 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, espresso in millisecondi. Il valore predefinito è 100 secondi.

overwrite
Boolean

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

Eccezioni

destinationFileName termina con una barra finale.

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

Il server non risponde all'interno dell'oggetto specificato connectionTimeout.

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

La richiesta viene negata dal server Web di destinazione.

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.

Note

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 .

Note

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 .

Per Vedi
Scaricare un file Procedura: Scaricare un file

Vedi anche

Si applica a

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

Scarica il file remoto specificato e lo salva 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 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, espresso 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 come risultato dell'impostazione showUI su True. Il valore predefinito è ThrowException.

Eccezioni

destinationFileName termina con una barra finale.

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

Il server non risponde all'interno dell'oggetto specificato connectionTimeout.

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

La richiesta viene negata dal server Web di destinazione.

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.

Note

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 .

Note

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 .

Per Vedi
Scaricare un file Procedura: Scaricare un file

Vedi anche

Si applica a

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

Scarica il file remoto specificato e lo salva 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 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 per l'autenticazione. 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, espresso in millisecondi. Il valore predefinito è 100 secondi.

overwrite
Boolean

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

Eccezioni

destinationFileName termina con una barra finale.

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

Il server non risponde all'interno dell'oggetto specificato connectionTimeout.

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

La richiesta viene negata dal server Web di destinazione.

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.

Note

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 .

Note

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 .

Per Vedi
Scaricare un file Procedura: Scaricare un file

Vedi anche

Si applica a

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

Scarica il file remoto specificato e lo salva 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 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 per l'autenticazione. 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, espresso 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 come risultato dell'impostazione ShowUI su True. Il valore predefinito è ThrowException.

Eccezioni

destinationFileName termina con una barra finale.

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

Il server non risponde all'interno dell'oggetto specificato connectionTimeout.

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

La richiesta viene negata dal server Web di destinazione.

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.

Note

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 .

Note

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 .

Per Vedi
Scaricare un file Procedura: Scaricare un file

Vedi anche

Si applica a

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

Scarica il file remoto specificato e lo salva 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 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 per l'autenticazione. 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, espresso 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 come risultato dell'impostazione ShowUI su True. Il valore predefinito è ThrowException.

Eccezioni

destinationFileName termina con una barra finale.

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

Il server non risponde all'interno dell'oggetto specificato connectionTimeout.

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

La richiesta viene negata dal server Web di destinazione.

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.

Note

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 .

Note

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 .

Per Vedi
Scaricare un file Procedura: Scaricare un file

Vedi anche

Si applica a