Network.DownloadFile Methode

Definitie

Naamruimte:: Microsoft.VisualBasic.Devices

Assembly:: Microsoft.VisualBasic.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.

Overloads

Name	Description
DownloadFile(String, String)	Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.
DownloadFile(Uri, String)	Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.
DownloadFile(String, String, String, String)	Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.
DownloadFile(Uri, String, String, String)	Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)	Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean)	Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)	Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)	Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.

DownloadFile(String, String)

Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.

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)

Parameters

address: String

Pad van het bestand dat moet worden gedownload, inclusief bestandsnaam en hostadres.

destinationFileName: String

Bestandsnaam en pad van het gedownloade bestand.

Uitzonderingen

ArgumentException

destinationFileName eindigt met een afsluitende slash.

TimeoutException

De server reageert niet binnen de standaardtime-out (100 seconden).

SecurityException

De gebruiker beschikt niet over de benodigde machtigingen om een netwerkbewerking uit te voeren.

WebException

De aanvraag wordt geweigerd door de doelwebserver.

Voorbeelden

In dit voorbeeld wordt het bestand WineList.txt gedownload http://www.cohowinery.com/downloads en opgeslagen 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 dit voorbeeld wordt het bestand WineList.txt gedownload http://www.cohowinery.com/downloads en opgeslagen C:\Documents and Settings\All Users\Documents, waarbij een time-outinterval van 500 milliseconden wordt opgegeven.

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

Opmerkingen

DownloadFile voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Netwerktracering inschakelen voor meer informatie.

Note

De DownloadFile methode verzendt geen optionele HTTP-headers. Sommige servers kunnen 500 (interne serverfout) retourneren als de optionele header van de gebruikersagent ontbreekt. Als u optionele headers wilt verzenden, moet u een aanvraag maken met behulp van de WebClient klasse.

De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.Network.DownloadFile methode.

Tot	Zien!
Een bestand downloaden	Procedure: Een bestand downloaden

Zie ook

Van toepassing op

DownloadFile(Uri, String)

Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.

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)

Parameters

address: Uri

Pad van het bestand dat moet worden gedownload, inclusief bestandsnaam en hostadres.

destinationFileName: String

Bestandsnaam en pad van het gedownloade bestand.

Uitzonderingen

ArgumentException

destinationFileName eindigt met een afsluitende slash.

TimeoutException

De server reageert niet binnen de standaardtime-out (100 seconden).

SecurityException

De gebruiker beschikt niet over de benodigde machtigingen om een netwerkbewerking uit te voeren.

WebException

De aanvraag wordt geweigerd door de doelwebserver.

Voorbeelden

In dit voorbeeld wordt het bestand WineList.txt gedownload http://www.cohowinery.com/downloads en opgeslagen in C:\Documents and Settings\All Users\Documents.

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

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

Opmerkingen

Als het doelbestand al bestaat, wordt het bestaande bestand niet overschreven door de DownloadFile methode. U kunt een van de andere overbelastingen van de DownloadFile methode gebruiken om deze te instrueren om bestaande bestanden te overschrijven, gebruikersreferenties op te geven of een specifieke time-outwaarde op te geven. DownloadFile voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Netwerktracering inschakelen voor meer informatie.

Note

De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.Network.DownloadFile methode.

Tot	Zien!
Een bestand downloaden	Procedure: Een bestand downloaden

Zie ook

Van toepassing op

DownloadFile(String, String, String, String)

Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.

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)

Parameters

address: String

Pad van het bestand dat moet worden gedownload, inclusief bestandsnaam en hostadres.

destinationFileName: String

Bestandsnaam en pad van het gedownloade bestand.

userName: String

Gebruikersnaam om te verifiëren. De standaardwaarde is een lege tekenreeks, ''.

password: String

Wachtwoord voor verificatie. De standaardwaarde is een lege tekenreeks, ''.

Uitzonderingen

ArgumentException

destinationFileName eindigt met een afsluitende slash.

TimeoutException

De server reageert niet binnen de standaardtime-out (100 seconden).

SecurityException

De gebruiker beschikt niet over de benodigde machtigingen om een netwerkbewerking uit te voeren.

WebException

De aanvraag wordt geweigerd door de doelwebserver.

Voorbeelden

In dit voorbeeld wordt het bestand WineList.txt gedownload http://www.cohowinery.com/downloads en opgeslagen in C:\Documents and Settings\All Users\Documents.

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

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

Opmerkingen

Als het doelbestand al bestaat, wordt het bestaande bestand niet overschreven door de DownloadFile methode. U kunt een van de andere overbelastingen van de methode gebruiken om deze DownloadFile te instrueren om bestaande bestanden te overschrijven of een specifieke time-outwaarde op te geven.

DownloadFile voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Netwerktracering inschakelen voor meer informatie.

Note

Het FTP-protocol verzendt informatie, inclusief wachtwoorden, in tekst zonder opmaak en mag niet worden gebruikt voor het verzenden van gevoelige informatie.

De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.Network.DownloadFile methode.

Tot	Zien!
Een bestand downloaden	Procedure: Een bestand downloaden

Zie ook

Van toepassing op

DownloadFile(Uri, String, String, String)

Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.

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)

Parameters

address: Uri

Pad van het bestand dat moet worden gedownload, inclusief bestandsnaam en hostadres.

destinationFileName: String

Bestandsnaam en pad van het gedownloade bestand.

userName: String

Gebruikersnaam om te verifiëren. De standaardwaarde is een lege tekenreeks, ''.

password: String

Wachtwoord voor verificatie. De standaardwaarde is een lege tekenreeks, ''.

Uitzonderingen

ArgumentException

destinationFileName eindigt met een afsluitende slash.

TimeoutException

De server reageert niet binnen de standaardtime-out (100 seconden).

SecurityException

De gebruiker beschikt niet over de benodigde machtigingen om een netwerkbewerking uit te voeren.

WebException

De aanvraag wordt geweigerd door de doelwebserver.

Voorbeelden

In dit voorbeeld wordt het bestand WineList.txt gedownload http://www.cohowinery.com/downloads en opgeslagen in C:\Documents and Settings\All Users\Documents.

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

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

Opmerkingen

DownloadFile voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Netwerktracering inschakelen voor meer informatie.

Note

Het FTP-protocol verzendt informatie, inclusief wachtwoorden, in tekst zonder opmaak en mag niet worden gebruikt voor het verzenden van gevoelige informatie.

De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.Network.DownloadFile methode.

Tot	Zien!
Een bestand downloaden	Procedure: Een bestand downloaden

Zie ook

Van toepassing op

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

Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.

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)

Parameters

address: Uri

String of Uri. Pad van het bestand dat moet worden gedownload, inclusief bestandsnaam en hostadres.

destinationFileName: String

String. Bestandsnaam en pad van het gedownloade bestand.

networkCredentials: ICredentials

ICredentials. Referenties die moeten worden opgegeven.

showUI: Boolean

True om de voortgang van de bewerking weer te geven; anders False. De standaardwaarde is False.

connectionTimeout: Int32

Time-outinterval, in milliseconden. De standaardwaarde is 100 seconden.

overwrite: Boolean

True bestaande bestanden te overschrijven; anders False. De standaardwaarde is False.

Uitzonderingen

ArgumentException

destinationFileName eindigt met een afsluitende slash.

IOException

overwrite is ingesteld op False en het doelbestand bestaat al.

TimeoutException

De server reageert niet binnen de opgegeven connectionTimeout.

SecurityException

De gebruiker beschikt niet over de benodigde machtigingen om een netwerkbewerking uit te voeren.

WebException

De aanvraag wordt geweigerd door de doelwebserver.

Voorbeelden

In dit voorbeeld wordt het bestand WineList.txt gedownload http://www.cohowinery.com/downloads en opgeslagen in C:\Documents and Settings\All Users\Documents.

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

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

Opmerkingen

Als showUI dit is ingesteld True, wordt er een dialoogvenster weergegeven waarin de voortgang van de bewerking wordt weergegeven. Het dialoogvenster bevat een knop Annuleren die kan worden gebruikt om de bewerking te annuleren. Het dialoogvenster is niet modaal en blokkeert daarom geen gebruikersinvoer voor andere vensters in het programma.

Als de server niet reageert binnen de opgegeven connectionTimeout, wordt de bewerking geannuleerd en wordt er een uitzondering gegenereerd.

DownloadFile voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Netwerktracering inschakelen voor meer informatie.

Note

Het FTP-protocol verzendt informatie, inclusief wachtwoorden, in tekst zonder opmaak en mag niet worden gebruikt voor het verzenden van gevoelige informatie.

De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.Network.DownloadFile methode.

Tot	Zien!
Een bestand downloaden	Procedure: Een bestand downloaden

Zie ook

Van toepassing op

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

Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.

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)

Parameters

address: String

Pad van het bestand dat moet worden gedownload, inclusief bestandsnaam en hostadres.

destinationFileName: String

Bestandsnaam en pad van het gedownloade bestand.

userName: String

Gebruikersnaam om te verifiëren. De standaardwaarde is een lege tekenreeks, ''.

password: String

Wachtwoord voor verificatie. De standaardwaarde is een lege tekenreeks, ''.

showUI: Boolean

True om de voortgang van de bewerking weer te geven; anders False. De standaardwaarde is False.

connectionTimeout: Int32

Int32. Time-outinterval, in milliseconden. De standaardwaarde is 100 seconden.

overwrite: Boolean

True bestaande bestanden te overschrijven; anders False. De standaardwaarde is False.

Uitzonderingen

ArgumentException

destinationFileName eindigt met een afsluitende slash.

IOException

overwrite is ingesteld op False en het doelbestand bestaat al.

TimeoutException

De server reageert niet binnen de opgegeven connectionTimeout.

SecurityException

De gebruiker beschikt niet over de benodigde machtigingen om een netwerkbewerking uit te voeren.

WebException

De aanvraag wordt geweigerd door de doelwebserver.

Voorbeelden

In dit voorbeeld wordt het bestand WineList.txt gedownload http://www.cohowinery.com/downloads en opgeslagen in C:\Documents and Settings\All Users\Documents.

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

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

Opmerkingen

Als de server niet reageert binnen de opgegeven connectionTimeout, wordt de bewerking geannuleerd en wordt er een uitzondering gegenereerd.

DownloadFile voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Netwerktracering inschakelen voor meer informatie.

Note

Het FTP-protocol verzendt informatie, inclusief wachtwoorden, in tekst zonder opmaak en mag niet worden gebruikt voor het verzenden van gevoelige informatie.

De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.Network.DownloadFile methode.

Tot	Zien!
Een bestand downloaden	Procedure: Een bestand downloaden

Zie ook

Van toepassing op

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

Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.

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)

Parameters

address: Uri

Pad van het bestand dat moet worden gedownload, inclusief bestandsnaam en hostadres.

destinationFileName: String

Bestandsnaam en pad van het gedownloade bestand.

networkCredentials: ICredentials

Referenties die moeten worden opgegeven.

showUI: Boolean

True om de voortgang van de bewerking weer te geven; anders False. De standaardwaarde is False.

connectionTimeout: Int32

Time-outinterval, in milliseconden. De standaardwaarde is 100 seconden.

overwrite: Boolean

True bestaande bestanden te overschrijven; anders False. De standaardwaarde is False.

onUserCancel: UICancelOption

Hiermee geeft u gedrag op wanneer de gebruiker op Annuleren of Nee klikt in het dialoogvenster dat wordt weergegeven als gevolg van showUI de set op True. De standaardwaarde is ThrowException.

Uitzonderingen

ArgumentException

destinationFileName eindigt met een afsluitende slash.

IOException

overwrite is ingesteld op False en het doelbestand bestaat al.

TimeoutException

De server reageert niet binnen de opgegeven connectionTimeout.

SecurityException

De gebruiker beschikt niet over de benodigde machtigingen om een netwerkbewerking uit te voeren.

WebException

De aanvraag wordt geweigerd door de doelwebserver.

Voorbeelden

In dit voorbeeld wordt het bestand WineList.txt gedownload http://www.cohowinery.com/downloads en opgeslagen in C:\Documents and Settings\All Users\Documents.

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

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

Opmerkingen

Als de server niet reageert binnen de opgegeven connectionTimeout, wordt de bewerking geannuleerd en wordt er een uitzondering gegenereerd.

DownloadFile voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Netwerktracering inschakelen voor meer informatie.

Note

Het FTP-protocol verzendt informatie, inclusief wachtwoorden, in tekst zonder opmaak en mag niet worden gebruikt voor het verzenden van gevoelige informatie.

De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.Network.DownloadFile methode.

Tot	Zien!
Een bestand downloaden	Procedure: Een bestand downloaden

Zie ook

Van toepassing op

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

Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.

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)

Parameters

address: Uri

Pad van het bestand dat moet worden gedownload, inclusief bestandsnaam en hostadres.

destinationFileName: String

Bestandsnaam en pad van het gedownloade bestand.

userName: String

Gebruikersnaam om te verifiëren. De standaardwaarde is een lege tekenreeks, ''.

password: String

Wachtwoord voor verificatie. De standaardwaarde is een lege tekenreeks, ''.

showUI: Boolean

True om de voortgang van de bewerking weer te geven; anders False. De standaardwaarde is False.

connectionTimeout: Int32

Time-outinterval, in milliseconden. De standaardwaarde is 100 seconden.

overwrite: Boolean

True bestaande bestanden te overschrijven; anders False. De standaardwaarde is False.

Uitzonderingen

ArgumentException

destinationFileName eindigt met een afsluitende slash.

IOException

overwrite is ingesteld op False en het doelbestand bestaat al.

TimeoutException

De server reageert niet binnen de opgegeven connectionTimeout.

SecurityException

De gebruiker beschikt niet over de benodigde machtigingen om een netwerkbewerking uit te voeren.

WebException

De aanvraag wordt geweigerd door de doelwebserver.

Voorbeelden

In dit voorbeeld wordt het bestand WineList.txt gedownload http://www.cohowinery.com/downloads en opgeslagen in C:\Documents and Settings\All Users\Documents.

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

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

Opmerkingen

Als de server niet reageert binnen de opgegeven connectionTimeout, wordt de bewerking geannuleerd en wordt er een uitzondering gegenereerd.

DownloadFile voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Netwerktracering inschakelen voor meer informatie.

Note

Het FTP-protocol verzendt informatie, inclusief wachtwoorden, in tekst zonder opmaak en mag niet worden gebruikt voor het verzenden van gevoelige informatie.

De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.Network.DownloadFile methode.

Tot	Zien!
Een bestand downloaden	Procedure: Een bestand downloaden

Zie ook

Van toepassing op

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

Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.

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)

Parameters

address: String

Pad van het bestand dat moet worden gedownload, inclusief bestandsnaam en hostadres.

destinationFileName: String

Bestandsnaam en pad van het gedownloade bestand.

userName: String

Gebruikersnaam om te verifiëren. De standaardwaarde is een lege tekenreeks, ''.

password: String

Wachtwoord voor verificatie. De standaardwaarde is een lege tekenreeks, ''.

showUI: Boolean

True om de voortgang van de bewerking weer te geven; anders False. De standaardwaarde is False.

connectionTimeout: Int32

Time-outinterval, in milliseconden. De standaardwaarde is 100 seconden.

overwrite: Boolean

True bestaande bestanden te overschrijven; anders False. De standaardwaarde is False.

onUserCancel: UICancelOption

Hiermee geeft u gedrag op wanneer de gebruiker op Annuleren of Nee klikt in het dialoogvenster dat wordt weergegeven als gevolg van ShowUI de set op True. De standaardwaarde is ThrowException.

Uitzonderingen

ArgumentException

destinationFileName eindigt met een afsluitende slash.

IOException

overwrite is ingesteld op False en het doelbestand bestaat al.

TimeoutException

De server reageert niet binnen de opgegeven connectionTimeout.

SecurityException

De gebruiker beschikt niet over de benodigde machtigingen om een netwerkbewerking uit te voeren.

WebException

De aanvraag wordt geweigerd door de doelwebserver.

Voorbeelden

In dit voorbeeld wordt het bestand WineList.txt gedownload http://www.cohowinery.com/downloads en opgeslagen in C:\Documents and Settings\All Users\Documents.

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

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

Opmerkingen

Als de server niet reageert binnen de opgegeven connectionTimeout, wordt de bewerking geannuleerd en wordt er een uitzondering gegenereerd.

DownloadFile voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Netwerktracering inschakelen voor meer informatie.

Note

Het FTP-protocol verzendt informatie, inclusief wachtwoorden, in tekst zonder opmaak en mag niet worden gebruikt voor het verzenden van gevoelige informatie.

De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.Network.DownloadFile methode.

Tot	Zien!
Een bestand downloaden	Procedure: Een bestand downloaden

Zie ook

Van toepassing op

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

Hiermee wordt het opgegeven externe bestand gedownload en opgeslagen op de opgegeven locatie.

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)

Parameters

address: Uri

Pad van het bestand dat moet worden gedownload, inclusief bestandsnaam en hostadres.

destinationFileName: String

Bestandsnaam en pad van het gedownloade bestand.

userName: String

Gebruikersnaam om te verifiëren. De standaardwaarde is een lege tekenreeks, ''.

password: String

Wachtwoord voor verificatie. De standaardwaarde is een lege tekenreeks, ''.

showUI: Boolean

True om de voortgang van de bewerking weer te geven; anders False. De standaardwaarde is False.

connectionTimeout: Int32

Time-outinterval, in milliseconden. De standaardwaarde is 100 seconden.

overwrite: Boolean

True bestaande bestanden te overschrijven; anders False. De standaardwaarde is False.

onUserCancel: UICancelOption

Uitzonderingen

ArgumentException

destinationFileName eindigt met een afsluitende slash.

IOException

overwrite is ingesteld op False en het doelbestand bestaat al.

TimeoutException

De server reageert niet binnen de opgegeven connectionTimeout.

SecurityException

De gebruiker beschikt niet over de benodigde machtigingen om een netwerkbewerking uit te voeren.

WebException

De aanvraag wordt geweigerd door de doelwebserver.

Voorbeelden

In dit voorbeeld wordt het bestand WineList.txt gedownload http://www.cohowinery.com/downloads en opgeslagen in C:\Documents and Settings\All Users\Documents.

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

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

Opmerkingen

Als de server niet reageert binnen de opgegeven connectionTimeout, wordt de bewerking geannuleerd en wordt er een uitzondering gegenereerd.

DownloadFile voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Netwerktracering inschakelen voor meer informatie.

Note

Het FTP-protocol verzendt informatie, inclusief wachtwoorden, in tekst zonder opmaak en mag niet worden gebruikt voor het verzenden van gevoelige informatie.

De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.Network.DownloadFile methode.

Tot	Zien!
Een bestand downloaden	Procedure: Een bestand downloaden

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?