Network.DownloadFile Metoda
Definice
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í
| 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 -> unitPublic 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
destinationFileName končí koncovým lomítkem.
Server nereaguje ve výchozím časovém limitu (100 sekund).
Uživatel nemá potřebná oprávnění k provedení síťové operace.
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
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 -> unitPublic 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
destinationFileName končí koncovým lomítkem.
Server nereaguje ve výchozím časovém limitu (100 sekund).
Uživatel nemá potřebná oprávnění k provedení síťové operace.
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
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 -> unitPublic 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
destinationFileName končí koncovým lomítkem.
Server nereaguje ve výchozím časovém limitu (100 sekund).
Uživatel nemá potřebná oprávnění k provedení síťové operace.
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
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 -> unitPublic 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
destinationFileName končí koncovým lomítkem.
Server nereaguje ve výchozím časovém limitu (100 sekund).
Uživatel nemá potřebná oprávnění k provedení síťové operace.
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
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 -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)Parametry
- 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
destinationFileName končí koncovým lomítkem.
overwrite je nastavená na False a cílový soubor již existuje.
Server neodpovědí v rámci zadaného parametru connectionTimeout.
Uživatel nemá potřebná oprávnění k provedení síťové operace.
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
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 -> unitPublic 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
destinationFileName končí koncovým lomítkem.
overwrite je nastavená na False a cílový soubor již existuje.
Server neodpovědí v rámci zadaného parametru connectionTimeout.
Uživatel nemá potřebná oprávnění k provedení síťové operace.
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
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 -> unitPublic 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
destinationFileName končí koncovým lomítkem.
overwrite je nastaven na False a cílový soubor již existuje.
Server neodpovědí v zadaném objektu connectionTimeout.
Uživatel nemá potřebná oprávnění k provedení síťové operace.
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
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 -> unitPublic 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
destinationFileName končí koncovým lomítkem.
overwrite je nastaven na False a cílový soubor již existuje.
Server neodpovědí v zadaném objektu connectionTimeout.
Uživatel nemá potřebná oprávnění k provedení síťové operace.
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
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 -> unitPublic Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)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
destinationFileName končí koncovým lomítkem.
overwrite je nastaven na False a cílový soubor již existuje.
Server neodpovědí v zadaném objektu connectionTimeout.
Uživatel nemá potřebná oprávnění k provedení síťové operace.
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
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 -> unitPublic Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)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
destinationFileName končí koncovým lomítkem.
overwrite je nastaven na False a cílový soubor již existuje.
Server neodpovědí v zadaném objektu connectionTimeout.
Uživatel nemá potřebná oprávnění k provedení síťové operace.
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
Platí pro
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro