Sdílet prostřednictvím


Network.DownloadFile Metoda

Definice

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

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é

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é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é

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é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é

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é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é

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é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é

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é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é

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 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é

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 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é

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 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é

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 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é

Platí pro