Network.DownloadFile Metodo

Definizione

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

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.

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

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

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

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.

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

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

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(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

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.

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

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

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 .

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

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.

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

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

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 .

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

destinationFileName termina con una barra finale.

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

Il server non risponde entro il connectionTimeout specificato.

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

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

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 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 .

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

destinationFileName termina con una barra finale.

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

Il server non risponde entro il connectionTimeout specificato.

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

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

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 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 .

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

destinationFileName termina con una barra finale.

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

Il server non risponde entro il connectionTimeout specificato.

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

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

destinationFileName termina con una barra finale.

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

Il server non risponde entro il connectionTimeout specificato.

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

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(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

destinationFileName termina con una barra finale.

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

Il server non risponde entro il connectionTimeout specificato.

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

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, 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

destinationFileName termina con una barra finale.

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

Il server non risponde entro il connectionTimeout specificato.

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

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