Network.DownloadFile Metodo
Definizione
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.
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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Come scaricare un file in Visual Basic
- Come: Analizzare i percorsi dei file in Visual Basic
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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Come scaricare un file in Visual Basic
- Come: Analizzare i percorsi dei file in Visual Basic
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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Come scaricare un file in Visual Basic
- Come: Analizzare i percorsi dei file in Visual Basic
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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Come scaricare un file in Visual Basic
- Come: Analizzare i percorsi dei file in Visual Basic
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
- 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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Come scaricare un file in Visual Basic
- Come: Analizzare i percorsi dei file in Visual Basic
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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Come scaricare un file in Visual Basic
- Come: Analizzare i percorsi dei file in Visual Basic
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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Come scaricare un file in Visual Basic
- Come: Analizzare i percorsi dei file in Visual Basic
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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Come scaricare un file in Visual Basic
- Come: Analizzare i percorsi dei file in Visual Basic
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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Come scaricare un file in Visual Basic
- Come: Analizzare i percorsi dei file in Visual Basic
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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Come scaricare un file in Visual Basic
- Come: Analizzare i percorsi dei file in Visual Basic