Network.DownloadFile Metoda

Definice

Obor názvů:: Microsoft.VisualBasic.Devices

Sestavení:: Microsoft.VisualBasic.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.

Přetížení

Name	Description
DownloadFile(String, String)	Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.
DownloadFile(Uri, String)	Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.
DownloadFile(String, String, String, String)	Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.
DownloadFile(Uri, String, String, String)	Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)	Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean)	Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)	Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)	Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.

DownloadFile(String, String)

Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.

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)

Parametry

address: String

Cesta k souboru ke stažení, včetně názvu souboru a adresy hostitele.

destinationFileName: String

Název souboru a cesta ke staženému souboru.

Výjimky

ArgumentException

destinationFileName končí koncové lomítko.

TimeoutException

Server nereaguje během výchozího časového limitu (100 sekund).

SecurityException

Uživatel nemá potřebná oprávnění k provedení síťové operace.

WebException

Požadavek je odepřen cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentssouboru .

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

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentsa určí časový limit 500 milisekund.

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

Poznámky

DownloadFile při povolení trasování sítě ve vaší aplikaci zobrazí informace o trasování sítě. Další informace naleznete v tématu Povolení trasování sítě.

Note

Metoda DownloadFile neodesílá volitelné hlavičky HTTP. Některé servery můžou vrátit hodnotu 500 (vnitřní chyba serveru), pokud chybí volitelná hlavička uživatelského agenta. Chcete-li odeslat volitelné hlavičky, je nutné vytvořit požadavek pomocí WebClient třídy.

Následující tabulka uvádí příklad úkolu zahrnujícího metodu My.Computer.Network.DownloadFile .

To	Podívejte se
Stažení souboru	Postupy: Stažení souboru

Viz také

Platí pro

DownloadFile(Uri, String)

Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.

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)

Parametry

address: Uri

Cesta k souboru ke stažení, včetně názvu souboru a adresy hostitele.

destinationFileName: String

Název souboru a cesta ke staženému souboru.

Výjimky

ArgumentException

destinationFileName končí koncové lomítko.

TimeoutException

Server nereaguje během výchozího časového limitu (100 sekund).

SecurityException

Uživatel nemá potřebná oprávnění k provedení síťové operace.

WebException

Požadavek je odepřen cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentssouboru .

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

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentsa určí časový limit 500 milisekund.

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

Poznámky

Pokud cílový soubor již existuje, DownloadFile metoda nepřepíše existující soubor. Pomocí jednoho z dalších přetížení DownloadFile metody ji můžete instruovat k přepsání existujících souborů, zadání přihlašovacích údajů uživatele nebo zadání konkrétní hodnoty časového limitu. DownloadFile při povolení trasování sítě ve vaší aplikaci zobrazí informace o trasování sítě. Další informace naleznete v tématu Povolení trasování sítě.

Note

Následující tabulka uvádí příklad úkolu zahrnujícího metodu My.Computer.Network.DownloadFile .

To	Podívejte se
Stažení souboru	Postupy: Stažení souboru

Viz také

Platí pro

DownloadFile(String, String, String, String)

Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.

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)

Parametry

address: String

Cesta k souboru ke stažení, včetně názvu souboru a adresy hostitele.

destinationFileName: String

Název souboru a cesta ke staženému souboru.

userName: String

Uživatelské jméno k ověření. Výchozí hodnota je prázdný řetězec "".

password: String

Heslo k ověření. Výchozí hodnota je prázdný řetězec "".

Výjimky

ArgumentException

destinationFileName končí koncové lomítko.

TimeoutException

Server nereaguje během výchozího časového limitu (100 sekund).

SecurityException

Uživatel nemá potřebná oprávnění k provedení síťové operace.

WebException

Požadavek je odepřen cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentssouboru .

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

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentsa určí časový limit 500 milisekund.

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

Poznámky

Pokud cílový soubor již existuje, DownloadFile metoda nepřepíše existující soubor. Můžete použít jedno z dalších přetížení DownloadFile metody dát pokyn, aby přepsal existující soubory nebo zadat konkrétní hodnotu časového limitu.

DownloadFile při povolení trasování sítě ve vaší aplikaci zobrazí informace o trasování sítě. Další informace naleznete v tématu Povolení trasování sítě.

Note

Protokol FTP odesílá informace, včetně hesel, ve formátu prostého textu a neměl by se používat k přenosu citlivých informací.

Následující tabulka uvádí příklad úkolu zahrnujícího metodu My.Computer.Network.DownloadFile .

To	Podívejte se
Stažení souboru	Postupy: Stažení souboru

Viz také

Platí pro

DownloadFile(Uri, String, String, String)

Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.

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)

Parametry

address: Uri

Cesta k souboru ke stažení, včetně názvu souboru a adresy hostitele.

destinationFileName: String

Název souboru a cesta ke staženému souboru.

userName: String

Uživatelské jméno k ověření. Výchozí hodnota je prázdný řetězec "".

password: String

Heslo k ověření. Výchozí hodnota je prázdný řetězec "".

Výjimky

ArgumentException

destinationFileName končí koncové lomítko.

TimeoutException

Server nereaguje během výchozího časového limitu (100 sekund).

SecurityException

Uživatel nemá potřebná oprávnění k provedení síťové operace.

WebException

Požadavek je odepřen cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentssouboru .

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

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentsa určí časový limit 500 milisekund.

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

Poznámky

DownloadFile při povolení trasování sítě ve vaší aplikaci zobrazí informace o trasování sítě. Další informace naleznete v tématu Povolení trasování sítě.

Note

Protokol FTP odesílá informace, včetně hesel, ve formátu prostého textu a neměl by se používat k přenosu citlivých informací.

Následující tabulka uvádí příklad úkolu zahrnujícího metodu My.Computer.Network.DownloadFile .

To	Podívejte se
Stažení souboru	Postupy: Stažení souboru

Viz také

Platí pro

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

Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.

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)

Parametry

address: Uri

String nebo Uri. Cesta k souboru ke stažení, včetně názvu souboru a adresy hostitele.

destinationFileName: String

String. Název souboru a cesta ke staženému souboru.

networkCredentials: ICredentials

ICredentials. Přihlašovací údaje, které se mají zadat.

showUI: Boolean

True k zobrazení průběhu operace; jinak False. Výchozí hodnota je False.

connectionTimeout: Int32

Interval časového limitu v milisekundách Výchozí hodnota je 100 sekund.

overwrite: Boolean

True přepsání existujících souborů; jinak False. Výchozí hodnota je False.

Výjimky

ArgumentException

destinationFileName končí koncové lomítko.

IOException

overwrite je nastavená na False cílový soubor a cílový soubor již existuje.

TimeoutException

Server neodpovídá v rámci zadaného connectionTimeout.

SecurityException

Uživatel nemá potřebná oprávnění k provedení síťové operace.

WebException

Požadavek je odepřen cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentssouboru .

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

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentsa určí časový limit 500 milisekund.

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

Poznámky

Pokud showUI je nastavená hodnota True, zobrazí se dialogové okno, které zobrazuje průběh operace. Dialogové okno obsahuje tlačítko Zrušit , které lze použít ke zrušení operace. Dialogové okno není modální, a proto neblokuje uživatelský vstup do jiných oken v programu.

Pokud server neodpovídá v rámci zadaného parametru connectionTimeout, operace se zruší a vyvolá se výjimka.

DownloadFile při povolení trasování sítě ve vaší aplikaci zobrazí informace o trasování sítě. Další informace naleznete v tématu Povolení trasování sítě.

Note

Protokol FTP odesílá informace, včetně hesel, ve formátu prostého textu a neměl by se používat k přenosu citlivých informací.

Následující tabulka uvádí příklad úkolu zahrnujícího metodu My.Computer.Network.DownloadFile .

To	Podívejte se
Stažení souboru	Postupy: Stažení souboru

Viz také

Platí pro

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

Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.

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)

Parametry

address: String

Cesta k souboru ke stažení, včetně názvu souboru a adresy hostitele.

destinationFileName: String

Název souboru a cesta ke staženému souboru.

userName: String

Uživatelské jméno k ověření. Výchozí hodnota je prázdný řetězec "".

password: String

Heslo k ověření. Výchozí hodnota je prázdný řetězec "".

showUI: Boolean

True k zobrazení průběhu operace; jinak False. Výchozí hodnota je False.

connectionTimeout: Int32

Int32. Interval časového limitu v milisekundách Výchozí hodnota je 100 sekund.

overwrite: Boolean

True přepsání existujících souborů; jinak False. Výchozí hodnota je False.

Výjimky

ArgumentException

destinationFileName končí koncové lomítko.

IOException

overwrite je nastavená na False cílový soubor a cílový soubor již existuje.

TimeoutException

Server neodpovídá v rámci zadaného connectionTimeout.

SecurityException

Uživatel nemá potřebná oprávnění k provedení síťové operace.

WebException

Požadavek je odepřen cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentssouboru .

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

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentsa určí časový limit 500 milisekund.

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

Poznámky

Pokud server neodpovídá v rámci zadaného parametru connectionTimeout, operace se zruší a vyvolá se výjimka.

DownloadFile při povolení trasování sítě ve vaší aplikaci zobrazí informace o trasování sítě. Další informace naleznete v tématu Povolení trasování sítě.

Note

Protokol FTP odesílá informace, včetně hesel, ve formátu prostého textu a neměl by se používat k přenosu citlivých informací.

Následující tabulka uvádí příklad úkolu zahrnujícího metodu My.Computer.Network.DownloadFile .

To	Podívejte se
Stažení souboru	Postupy: Stažení souboru

Viz také

Platí pro

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

Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.

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)

Parametry

address: Uri

Cesta k souboru ke stažení, včetně názvu souboru a adresy hostitele.

destinationFileName: String

Název souboru a cesta ke staženému souboru.

networkCredentials: ICredentials

Přihlašovací údaje, které se mají zadat.

showUI: Boolean

True k zobrazení průběhu operace; jinak False. Výchozí hodnota je False.

connectionTimeout: Int32

Interval časového limitu v milisekundách Výchozí hodnota je 100 sekund.

overwrite: Boolean

True přepsání existujících souborů; jinak False. Výchozí hodnota je False.

onUserCancel: UICancelOption

Určuje chování, když uživatel klikne na tlačítko Storno nebo Ne v dialogovém okně zobrazeném jako výsledek nastavené na showUITruehodnotu . Výchozí hodnota je ThrowException.

Výjimky

ArgumentException

destinationFileName končí koncové lomítko.

IOException

overwrite je nastavená na False cílový soubor a cílový soubor již existuje.

TimeoutException

Server neodpovídá v rámci zadaného connectionTimeout.

SecurityException

Uživatel nemá potřebná oprávnění k provedení síťové operace.

WebException

Požadavek je odepřen cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentssouboru .

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

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentsa určí časový limit 500 milisekund.

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

Poznámky

Pokud server neodpovídá v rámci zadaného parametru connectionTimeout, operace se zruší a vyvolá se výjimka.

DownloadFile při povolení trasování sítě ve vaší aplikaci zobrazí informace o trasování sítě. Další informace naleznete v tématu Povolení trasování sítě.

Note

Protokol FTP odesílá informace, včetně hesel, ve formátu prostého textu a neměl by se používat k přenosu citlivých informací.

Následující tabulka uvádí příklad úkolu zahrnujícího metodu My.Computer.Network.DownloadFile .

To	Podívejte se
Stažení souboru	Postupy: Stažení souboru

Viz také

Platí pro

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

Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.

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)

Parametry

address: Uri

Cesta k souboru ke stažení, včetně názvu souboru a adresy hostitele.

destinationFileName: String

Název souboru a cesta ke staženému souboru.

userName: String

Uživatelské jméno k ověření. Výchozí hodnota je prázdný řetězec "".

password: String

Heslo k ověření. Výchozí hodnota je prázdný řetězec "".

showUI: Boolean

True k zobrazení průběhu operace; jinak False. Výchozí hodnota je False.

connectionTimeout: Int32

Interval časového limitu v milisekundách Výchozí hodnota je 100 sekund.

overwrite: Boolean

True přepsání existujících souborů; jinak False. Výchozí hodnota je False.

Výjimky

ArgumentException

destinationFileName končí koncové lomítko.

IOException

overwrite je nastavená na False cílový soubor a cílový soubor již existuje.

TimeoutException

Server neodpovídá v rámci zadaného connectionTimeout.

SecurityException

Uživatel nemá potřebná oprávnění k provedení síťové operace.

WebException

Požadavek je odepřen cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentssouboru .

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

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentsa určí časový limit 500 milisekund.

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

Poznámky

Pokud server neodpovídá v rámci zadaného parametru connectionTimeout, operace se zruší a vyvolá se výjimka.

DownloadFile při povolení trasování sítě ve vaší aplikaci zobrazí informace o trasování sítě. Další informace naleznete v tématu Povolení trasování sítě.

Note

Protokol FTP odesílá informace, včetně hesel, ve formátu prostého textu a neměl by se používat k přenosu citlivých informací.

Následující tabulka uvádí příklad úkolu zahrnujícího metodu My.Computer.Network.DownloadFile .

To	Podívejte se
Stažení souboru	Postupy: Stažení souboru

Viz také

Platí pro

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

Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.

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)

Parametry

address: String

Cesta k souboru ke stažení, včetně názvu souboru a adresy hostitele.

destinationFileName: String

Název souboru a cesta ke staženému souboru.

userName: String

Uživatelské jméno k ověření. Výchozí hodnota je prázdný řetězec "".

password: String

Heslo k ověření. Výchozí hodnota je prázdný řetězec "".

showUI: Boolean

True k zobrazení průběhu operace; jinak False. Výchozí hodnota je False.

connectionTimeout: Int32

Interval časového limitu v milisekundách Výchozí hodnota je 100 sekund.

overwrite: Boolean

True přepsání existujících souborů; jinak False. Výchozí hodnota je False.

onUserCancel: UICancelOption

Určuje chování, když uživatel klikne na tlačítko Storno nebo Ne v dialogovém okně zobrazeném jako výsledek nastavené na ShowUITruehodnotu . Výchozí hodnota je ThrowException.

Výjimky

ArgumentException

destinationFileName končí koncové lomítko.

IOException

overwrite je nastavená na False cílový soubor a cílový soubor již existuje.

TimeoutException

Server neodpovídá v rámci zadaného connectionTimeout.

SecurityException

Uživatel nemá potřebná oprávnění k provedení síťové operace.

WebException

Požadavek je odepřen cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentssouboru .

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

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentsa určí časový limit 500 milisekund.

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

Poznámky

Pokud server neodpovídá v rámci zadaného parametru connectionTimeout, operace se zruší a vyvolá se výjimka.

DownloadFile při povolení trasování sítě ve vaší aplikaci zobrazí informace o trasování sítě. Další informace naleznete v tématu Povolení trasování sítě.

Note

Protokol FTP odesílá informace, včetně hesel, ve formátu prostého textu a neměl by se používat k přenosu citlivých informací.

Následující tabulka uvádí příklad úkolu zahrnujícího metodu My.Computer.Network.DownloadFile .

To	Podívejte se
Stažení souboru	Postupy: Stažení souboru

Viz také

Platí pro

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

Stáhne zadaný vzdálený soubor a uloží ho do zadaného umístění.

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)

Parametry

address: Uri

Cesta k souboru ke stažení, včetně názvu souboru a adresy hostitele.

destinationFileName: String

Název souboru a cesta ke staženému souboru.

userName: String

Uživatelské jméno k ověření. Výchozí hodnota je prázdný řetězec "".

password: String

Heslo k ověření. Výchozí hodnota je prázdný řetězec "".

showUI: Boolean

True k zobrazení průběhu operace; jinak False. Výchozí hodnota je False.

connectionTimeout: Int32

Interval časového limitu v milisekundách Výchozí hodnota je 100 sekund.

overwrite: Boolean

True přepsání existujících souborů; jinak False. Výchozí hodnota je False.

onUserCancel: UICancelOption

Určuje chování, když uživatel klikne na tlačítko Storno nebo Ne v dialogovém okně zobrazeném jako výsledek nastavené na ShowUITruehodnotu . Výchozí hodnota je ThrowException.

Výjimky

ArgumentException

destinationFileName končí koncové lomítko.

IOException

overwrite je nastavená na False cílový soubor a cílový soubor již existuje.

TimeoutException

Server neodpovídá v rámci zadaného connectionTimeout.

SecurityException

Uživatel nemá potřebná oprávnění k provedení síťové operace.

WebException

Požadavek je odepřen cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentssouboru .

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

Tento příklad stáhne soubor WineList.txt a http://www.cohowinery.com/downloads uloží ho do C:\Documents and Settings\All Users\Documentsa určí časový limit 500 milisekund.

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

Poznámky

Pokud server neodpovídá v rámci zadaného parametru connectionTimeout, operace se zruší a vyvolá se výjimka.

DownloadFile při povolení trasování sítě ve vaší aplikaci zobrazí informace o trasování sítě. Další informace naleznete v tématu Povolení trasování sítě.

Note

Protokol FTP odesílá informace, včetně hesel, ve formátu prostého textu a neměl by se používat k přenosu citlivých informací.

Následující tabulka uvádí příklad úkolu zahrnujícího metodu My.Computer.Network.DownloadFile .

To	Podívejte se
Stažení souboru	Postupy: Stažení souboru

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?