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.
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 -> unitPublic 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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Procedura: scaricare file in Visual Basic
- Procedura: analizzare percorsi di file in Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Procedura: scaricare file in Visual Basic
- Procedura: analizzare percorsi di file in Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Procedura: scaricare file in Visual Basic
- Procedura: analizzare percorsi di file in Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Procedura: scaricare file in Visual Basic
- Procedura: analizzare percorsi di file in Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Procedura: scaricare file in Visual Basic
- Procedura: analizzare percorsi di file in Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Procedura: scaricare file in Visual Basic
- Procedura: analizzare percorsi di file in Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Procedura: scaricare file in Visual Basic
- Procedura: analizzare percorsi di file in Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Procedura: scaricare file in Visual Basic
- Procedura: analizzare percorsi di file in Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Procedura: scaricare file in Visual Basic
- Procedura: analizzare percorsi di file in Visual Basic
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 -> unitPublic 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
- Uri
- ICredentials
- Oggetti (Visual Basic)
- Procedura: scaricare file in Visual Basic
- Procedura: analizzare percorsi di file in Visual Basic
Si applica a
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per