Network.DownloadFile Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.Devices

Sestavení:

Microsoft.VisualBasic.Forms.dll

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

Přetížení

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ého souboru.

Výjimky

ArgumentException

destinationFileName končí koncovým lomítkem.

TimeoutException

Server nereaguje ve výchozím časovém limitu (100 sekund).

SecurityException

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

WebException

Požadavek byl odmítnut cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do 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")

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do C:\Documents and Settings\All Users\Documentssouboru , který určuje interval časového limitu 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 můžete dát pokyn k přepsání existujících souborů, zadání přihlašovacích údajů uživatele nebo určení konkrétní hodnoty časového limitu.

DownloadFile výstupy trasování informace, když povolíte trasování sítě ve vaší aplikaci. Další informace najdete v tématu Povolení trasování sítě.

Poznámka

Metoda DownloadFile neodesílá volitelné hlavičky HTTP. Některé servery můžou vrátit chybu 500 (vnitřní chyba serveru), pokud chybí volitelná hlavička uživatelského agenta. Pokud chcete odesílat volitelné hlavičky, musíte vytvořit požadavek pomocí WebClient třídy .

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

Záměr	Seznamte se s
Stažení souboru	Postupy: Stažení souboru

Viz také

• Uri
• ICredentials
• Objekty (Visual Basic)
• Postupy: Stažení souboru v jazyce Visual Basic
• Postupy: Analýza cest k souborům v jazyce Visual Basic

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ého souboru.

Výjimky

ArgumentException

destinationFileName končí koncovým lomítkem.

TimeoutException

Server nereaguje ve výchozím časovém limitu (100 sekund).

SecurityException

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

WebException

Požadavek byl odmítnut cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do 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")

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do C:\Documents and Settings\All Users\Documentssouboru , který určuje interval časového limitu 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 můžete dát pokyn k přepsání existujících souborů, zadání přihlašovacích údajů uživatele nebo určení konkrétní hodnoty časového limitu. DownloadFile výstupy trasování informace, když povolíte trasování sítě ve vaší aplikaci. Další informace najdete v tématu Povolení trasování sítě.

Poznámka

Metoda DownloadFile neodesílá volitelné hlavičky HTTP. Některé servery můžou vrátit chybu 500 (vnitřní chyba serveru), pokud chybí volitelná hlavička uživatelského agenta. Pokud chcete odesílat volitelné hlavičky, musíte vytvořit požadavek pomocí WebClient třídy .

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

Záměr	Seznamte se s
Stažení souboru	Postupy: Stažení souboru

Viz také

• Uri
• ICredentials
• Objekty (Visual Basic)
• Postupy: Stažení souboru v jazyce Visual Basic
• Postupy: Analýza cest k souborům v jazyce Visual Basic

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ého 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ým lomítkem.

TimeoutException

Server nereaguje ve výchozím časovém limitu (100 sekund).

SecurityException

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

WebException

Požadavek byl odmítnut cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do 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")

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do C:\Documents and Settings\All Users\Documentssouboru , který určuje interval časového limitu 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í metody k pokynu DownloadFile k přepsání existujících souborů nebo určení konkrétní hodnoty časového limitu.

DownloadFile výstupy trasování informace, když povolíte trasování sítě ve vaší aplikaci. Další informace najdete v tématu Povolení trasování sítě.

Poznámka

Metoda DownloadFile neodesílá volitelné hlavičky HTTP. Některé servery můžou vrátit chybu 500 (vnitřní chyba serveru), pokud chybí volitelná hlavička uživatelského agenta. Pokud chcete odesílat volitelné hlavičky, musíte vytvořit požadavek pomocí WebClient třídy .

Poznámka

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 úlohy zahrnující metodu My.Computer.Network.DownloadFile .

Záměr	Seznamte se s
Stažení souboru	Postupy: Stažení souboru

Viz také

• Uri
• ICredentials
• Objekty (Visual Basic)
• Postupy: Stažení souboru v jazyce Visual Basic
• Postupy: Analýza cest k souborům v jazyce Visual Basic

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ého 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ým lomítkem.

TimeoutException

Server nereaguje ve výchozím časovém limitu (100 sekund).

SecurityException

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

WebException

Požadavek byl odmítnut cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do 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")

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do C:\Documents and Settings\All Users\Documentssouboru , který určuje interval časového limitu 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í metody k pokynu DownloadFile k přepsání existujících souborů nebo určení konkrétní hodnoty časového limitu.

DownloadFile výstupy trasování informace, když povolíte trasování sítě ve vaší aplikaci. Další informace najdete v tématu Povolení trasování sítě.

Poznámka

Metoda DownloadFile neodesílá volitelné hlavičky HTTP. Některé servery můžou vrátit chybu 500 (vnitřní chyba serveru), pokud chybí volitelná hlavička uživatelského agenta. Pokud chcete odesílat volitelné hlavičky, musíte vytvořit požadavek pomocí WebClient třídy .

Poznámka

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 úlohy zahrnující metodu My.Computer.Network.DownloadFile .

Záměr	Seznamte se s
Stažení souboru	Postupy: Stažení souboru

Viz také

• Uri
• ICredentials
• Objekty (Visual Basic)
• Postupy: Stažení souboru v jazyce Visual Basic
• Postupy: Analýza cest k souborům v jazyce Visual Basic

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ého 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í je False.

connectionTimeout

Int32

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

overwrite

Boolean

True přepsat existující soubory; jinak False. Výchozí je False.

Výjimky

ArgumentException

destinationFileName končí koncovým lomítkem.

IOException

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

TimeoutException

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

SecurityException

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

WebException

Požadavek byl odmítnut cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do 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")

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do C:\Documents and Settings\All Users\Documentssouboru , který určuje interval časového limitu 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 s průběhem operace. Toto dialogové okno obsahuje tlačítko Zrušit , které lze použít ke zrušení operace. Dialogové okno není modální, a proto neblokuje vstup uživatele do jiných oken v programu.

Pokud server neodpoví v zadaném connectionTimeoutparametru , operace se zruší a vyvolá se výjimka.

DownloadFile výstupy trasování informace, když povolíte trasování sítě ve vaší aplikaci. Další informace najdete v tématu Povolení trasování sítě.

Poznámka

Metoda DownloadFile neodesílá volitelné hlavičky HTTP. Některé servery můžou vrátit chybu 500 (vnitřní chyba serveru), pokud chybí volitelná hlavička uživatelského agenta. Pokud chcete odesílat volitelné hlavičky, musíte vytvořit požadavek pomocí WebClient třídy .

Poznámka

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 úlohy zahrnující metodu My.Computer.Network.DownloadFile .

Záměr	Seznamte se s
Stažení souboru	Postupy: Stažení souboru

Viz také

• Uri
• ICredentials
• Objekty (Visual Basic)
• Postupy: Stažení souboru v jazyce Visual Basic
• Postupy: Analýza cest k souborům v jazyce Visual Basic

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ého 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í je False.

connectionTimeout

Int32

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

overwrite

Boolean

True přepsat existující soubory; jinak False. Výchozí je False.

Výjimky

ArgumentException

destinationFileName končí koncovým lomítkem.

IOException

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

TimeoutException

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

SecurityException

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

WebException

Požadavek byl odmítnut cílovým webovým serverem.

Příklady

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do 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")

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do C:\Documents and Settings\All Users\Documentssouboru , který určuje interval časového limitu 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 s průběhem operace. Toto dialogové okno obsahuje tlačítko Zrušit , které lze použít ke zrušení operace. Dialogové okno není modální, a proto neblokuje vstup uživatele do jiných oken v programu.

Pokud server neodpoví v zadaném connectionTimeoutparametru , operace se zruší a vyvolá se výjimka.

DownloadFile výstupy trasování informace, když povolíte trasování sítě ve vaší aplikaci. Další informace najdete v tématu Povolení trasování sítě.

Poznámka

Metoda DownloadFile neodesílá volitelné hlavičky HTTP. Některé servery můžou vrátit chybu 500 (vnitřní chyba serveru), pokud chybí volitelná hlavička uživatelského agenta. Pokud chcete odesílat volitelné hlavičky, musíte vytvořit požadavek pomocí WebClient třídy .

Poznámka

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

V následující tabulce je uveden příklad úlohy zahrnující metodu My.Computer.Network.DownloadFile .

Záměr	Seznamte se s
Stažení souboru	Postupy: Stažení souboru

Viz také

• Uri
• ICredentials
• Objekty (Visual Basic)
• Postupy: Stažení souboru v jazyce Visual Basic
• Postupy: Analýza cest k souborům v jazyce Visual Basic

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 ke stažení souboru, včetně názvu souboru a adresy hostitele.

destinationFileName

String

Název souboru a cesta ke staženým souborům.

networkCredentials

ICredentials

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

showUI

Boolean

True zobrazit průběh operace; jinak False. Výchozí je False.

connectionTimeout

Int32

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

overwrite

Boolean

True přepsat existující soubory; jinak False. Výchozí je False.

onUserCancel

UICancelOption

Určuje chování, když uživatel klikne na Zrušit nebo Ne v dialogovém okně zobrazeném jako výsledek showUI nastavení na True. Výchozí je ThrowException.

Výjimky

ArgumentException

destinationFileName končí koncovým lomítkem.

IOException

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

TimeoutException

Server neodpovědí v zadaném objektu connectionTimeout.

SecurityException

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

WebException

Cílový webový server požadavek zamítl.

Příklady

Tento příklad stáhne soubor WineList.txt ze http://www.cohowinery.com/downloads souboru a uloží ho do 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")

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do C:\Documents and Settings\All Users\Documentssouboru , který určuje č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 s průběhem operace. Toto dialogové okno obsahuje tlačítko Zrušit , které lze použít ke zrušení operace. Dialogové okno není modální, a proto neblokuje vstup uživatele do jiných oken v programu.

Pokud server neodpoví v zadaném connectionTimeoutparametru , operace se zruší a vyvolá se výjimka.

DownloadFile výstupy trasování informací, když povolíte trasování sítě ve vaší aplikaci. Další informace najdete v tématu Povolení trasování sítě.

Poznámka

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

Poznámka

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

V následující tabulce je uveden příklad úlohy zahrnující metodu My.Computer.Network.DownloadFile .

Záměr	Seznamte se s
Stažení souboru	Postupy: Stažení souboru

Viz také

• Uri
• ICredentials
• Objekty (Visual Basic)
• Postupy: Stažení souboru v jazyce Visual Basic
• Postupy: Analýza cest k souborům v jazyce Visual Basic

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 ke stažení souboru, včetně názvu souboru a adresy hostitele.

destinationFileName

String

Název souboru a cesta ke staženým souborům.

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 zobrazit průběh operace; jinak False. Výchozí je False.

connectionTimeout

Int32

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

overwrite

Boolean

True přepsat existující soubory; jinak False. Výchozí je False.

Výjimky

ArgumentException

destinationFileName končí koncovým lomítkem.

IOException

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

TimeoutException

Server neodpovědí v zadaném objektu connectionTimeout.

SecurityException

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

WebException

Cílový webový server požadavek zamítl.

Příklady

Tento příklad stáhne soubor WineList.txt ze http://www.cohowinery.com/downloads souboru a uloží ho do 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")

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do C:\Documents and Settings\All Users\Documentssouboru , který určuje č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 s průběhem operace. Toto dialogové okno obsahuje tlačítko Zrušit , které lze použít ke zrušení operace. Dialogové okno není modální, a proto neblokuje vstup uživatele do jiných oken v programu.

Pokud server neodpoví v zadaném connectionTimeoutparametru , operace se zruší a vyvolá se výjimka.

DownloadFile výstupy trasování informací, když povolíte trasování sítě ve vaší aplikaci. Další informace najdete v tématu Povolení trasování sítě.

Poznámka

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

Poznámka

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

V následující tabulce je uveden příklad úlohy zahrnující metodu My.Computer.Network.DownloadFile .

Záměr	Seznamte se s
Stažení souboru	Postupy: Stažení souboru

Viz také

• Uri
• ICredentials
• Objekty (Visual Basic)
• Postupy: Stažení souboru v jazyce Visual Basic
• Postupy: Analýza cest k souborům v jazyce Visual Basic

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 ke stažení souboru, včetně názvu souboru a adresy hostitele.

destinationFileName

String

Název souboru a cesta ke staženým souborům.

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 zobrazit průběh operace; jinak False. Výchozí je False.

connectionTimeout

Int32

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

overwrite

Boolean

True přepsat existující soubory; jinak False. Výchozí je False.

onUserCancel

UICancelOption

Určuje chování, když uživatel klikne na Zrušit nebo Ne v dialogovém okně zobrazeném jako výsledek ShowUI nastavení na True. Výchozí je ThrowException.

Výjimky

ArgumentException

destinationFileName končí koncovým lomítkem.

IOException

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

TimeoutException

Server neodpovědí v zadaném objektu connectionTimeout.

SecurityException

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

WebException

Cílový webový server požadavek zamítl.

Příklady

Tento příklad stáhne soubor WineList.txt ze http://www.cohowinery.com/downloads souboru a uloží ho do 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")

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do C:\Documents and Settings\All Users\Documentssouboru , který určuje č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 s průběhem operace. Toto dialogové okno obsahuje tlačítko Zrušit , které lze použít ke zrušení operace. Dialogové okno není modální, a proto neblokuje vstup uživatele do jiných oken v programu.

Pokud server neodpoví v zadaném connectionTimeoutparametru , operace se zruší a vyvolá se výjimka.

DownloadFile výstupy trasování informací, když povolíte trasování sítě ve vaší aplikaci. Další informace najdete v tématu Povolení trasování sítě.

Poznámka

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

Poznámka

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

V následující tabulce je uveden příklad úlohy zahrnující metodu My.Computer.Network.DownloadFile .

Záměr	Seznamte se s
Stažení souboru	Postupy: Stažení souboru

Viz také

• Uri
• ICredentials
• Objekty (Visual Basic)
• Postupy: Stažení souboru v jazyce Visual Basic
• Postupy: Analýza cest k souborům v jazyce Visual Basic

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 ke stažení souboru, včetně názvu souboru a adresy hostitele.

destinationFileName

String

Název souboru a cesta ke staženým souborům.

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 zobrazit průběh operace; jinak False. Výchozí je False.

connectionTimeout

Int32

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

overwrite

Boolean

True přepsat existující soubory; jinak False. Výchozí je False.

onUserCancel

UICancelOption

Určuje chování, když uživatel klikne na Zrušit nebo Ne v dialogovém okně zobrazeném jako výsledek ShowUI nastavení na True. Výchozí je ThrowException.

Výjimky

ArgumentException

destinationFileName končí koncovým lomítkem.

IOException

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

TimeoutException

Server neodpovědí v zadaném objektu connectionTimeout.

SecurityException

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

WebException

Cílový webový server požadavek zamítl.

Příklady

Tento příklad stáhne soubor WineList.txt ze http://www.cohowinery.com/downloads souboru a uloží ho do 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")

Tento příklad stáhne soubor WineList.txt z http://www.cohowinery.com/downloads a uloží ho do C:\Documents and Settings\All Users\Documentssouboru , který určuje č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 s průběhem operace. Toto dialogové okno obsahuje tlačítko Zrušit , které lze použít ke zrušení operace. Dialogové okno není modální, a proto neblokuje vstup uživatele do jiných oken v programu.

Pokud server neodpoví v zadaném connectionTimeoutparametru , operace se zruší a vyvolá se výjimka.

DownloadFile výstupy trasování informací, když povolíte trasování sítě ve vaší aplikaci. Další informace najdete v tématu Povolení trasování sítě.

Poznámka

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

Poznámka

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

V následující tabulce je uveden příklad úlohy zahrnující metodu My.Computer.Network.DownloadFile .

Záměr	Seznamte se s
Stažení souboru	Postupy: Stažení souboru

Viz také

• Uri
• ICredentials
• Objekty (Visual Basic)
• Postupy: Stažení souboru v jazyce Visual Basic
• Postupy: Analýza cest k souborům v jazyce Visual Basic