Network.DownloadFile Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Letölti a megadott távoli fájlt, és a megadott helyre menti.
Túlterhelések
| Name | Description |
|---|---|
| DownloadFile(String, String) |
Letölti a megadott távoli fájlt, és a megadott helyre menti. |
| DownloadFile(Uri, String) |
Letölti a megadott távoli fájlt, és a megadott helyre menti. |
| DownloadFile(String, String, String, String) |
Letölti a megadott távoli fájlt, és a megadott helyre menti. |
| DownloadFile(Uri, String, String, String) |
Letölti a megadott távoli fájlt, és a megadott helyre menti. |
| DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean) |
Letölti a megadott távoli fájlt, és a megadott helyre menti. |
| DownloadFile(String, String, String, String, Boolean, Int32, Boolean) |
Letölti a megadott távoli fájlt, és a megadott helyre menti. |
| DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption) |
Letölti a megadott távoli fájlt, és a megadott helyre menti. |
| DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean) |
Letölti a megadott távoli fájlt, és a megadott helyre menti. |
| DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption) |
Letölti a megadott távoli fájlt, és a megadott helyre menti. |
| DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption) |
Letölti a megadott távoli fájlt, és a megadott helyre menti. |
DownloadFile(String, String)
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
Letölti a megadott távoli fájlt, és a megadott helyre menti.
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)
Paraméterek
- address
- String
A letöltendő fájl elérési útja, beleértve a fájlnevet és a gazdagép címét.
- destinationFileName
- String
A letöltött fájl neve és elérési útja.
Kivételek
destinationFileName záró perjellel végződik.
A kiszolgáló nem válaszol az alapértelmezett időtúllépésen belül (100 másodperc).
A felhasználó nem rendelkezik a hálózati művelet végrehajtásához szükséges engedélyekkel.
A kérést a cél webkiszolgáló elutasítja.
Példák
Ez a példa letölti a fájlt, WineList.txt és menti a fájlba.http://www.cohowinery.com/downloadsC:\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")
Ez a példa letölti és menti WineList.txta fájlt http://www.cohowinery.com/downloadsC:\Documents and Settings\All Users\Documents, 500 ezredmásodperc időtúllépési időközt megadva.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Megjegyzések
Ha a célfájl már létezik, a DownloadFile metódus nem írja felül a meglévő fájlt. A metódus többi túlterhelésének egyikével DownloadFile utasíthatja a meglévő fájlok felülírására, a felhasználói hitelesítő adatok megadására vagy egy adott időtúllépési érték megadására.
DownloadFile nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Hálózatkövetés engedélyezése.
Note
A DownloadFile metódus nem küld opcionális HTTP-fejléceket. Egyes kiszolgálók 500-et (belső kiszolgálóhibát) adhatnak vissza, ha hiányzik az opcionális felhasználói ügynök fejléce. Az opcionális fejlécek küldéséhez létre kell készítenie egy kérést az WebClient osztály használatával.
Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.Network.DownloadFile .
| Címzett | Nézze |
|---|---|
| Fájl letöltése | Útmutató: Fájl letöltése |
Lásd még
- Uri
- ICredentials
- Objects (Visual Basic)
Bemutató: Fájl letöltése Visual Basic Bemutató: Fájlelérési útvonalak elemzése a Visual Basic
A következőre érvényes:
DownloadFile(Uri, String)
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
Letölti a megadott távoli fájlt, és a megadott helyre menti.
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)
Paraméterek
- address
- Uri
A letöltendő fájl elérési útja, beleértve a fájlnevet és a gazdagép címét.
- destinationFileName
- String
A letöltött fájl neve és elérési útja.
Kivételek
destinationFileName záró perjellel végződik.
A kiszolgáló nem válaszol az alapértelmezett időtúllépésen belül (100 másodperc).
A felhasználó nem rendelkezik a hálózati művelet végrehajtásához szükséges engedélyekkel.
A kérést a cél webkiszolgáló elutasítja.
Példák
Ez a példa letölti a fájlt, WineList.txt és menti a fájlba.http://www.cohowinery.com/downloadsC:\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")
Ez a példa letölti és menti WineList.txta fájlt http://www.cohowinery.com/downloadsC:\Documents and Settings\All Users\Documents, 500 ezredmásodperc időtúllépési időközt megadva.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Megjegyzések
Ha a célfájl már létezik, a DownloadFile metódus nem írja felül a meglévő fájlt. A metódus többi túlterhelésének egyikével DownloadFile utasíthatja a meglévő fájlok felülírására, a felhasználói hitelesítő adatok megadására vagy egy adott időtúllépési érték megadására.
DownloadFile nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Hálózatkövetés engedélyezése.
Note
A DownloadFile metódus nem küld opcionális HTTP-fejléceket. Egyes kiszolgálók 500-et (belső kiszolgálóhibát) adhatnak vissza, ha hiányzik az opcionális felhasználói ügynök fejléce. Az opcionális fejlécek küldéséhez létre kell készítenie egy kérést az WebClient osztály használatával.
Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.Network.DownloadFile .
| Címzett | Nézze |
|---|---|
| Fájl letöltése | Útmutató: Fájl letöltése |
Lásd még
- Uri
- ICredentials
- Objects (Visual Basic)
Bemutató: Fájl letöltése Visual Basic Bemutató: Fájlelérési útvonalak elemzése a Visual Basic
A következőre érvényes:
DownloadFile(String, String, String, String)
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
Letölti a megadott távoli fájlt, és a megadott helyre menti.
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)
Paraméterek
- address
- String
A letöltendő fájl elérési útja, beleértve a fájlnevet és a gazdagép címét.
- destinationFileName
- String
A letöltött fájl neve és elérési útja.
- userName
- String
Hitelesítéshez megadott felhasználónév. Az alapértelmezett érték egy üres sztring, "".
- password
- String
Jelszó a hitelesítéshez. Az alapértelmezett érték egy üres sztring, "".
Kivételek
destinationFileName záró perjellel végződik.
A kiszolgáló nem válaszol az alapértelmezett időtúllépésen belül (100 másodperc).
A felhasználó nem rendelkezik a hálózati művelet végrehajtásához szükséges engedélyekkel.
A kérést a cél webkiszolgáló elutasítja.
Példák
Ez a példa letölti a fájlt, WineList.txt és menti a fájlba.http://www.cohowinery.com/downloadsC:\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")
Ez a példa letölti és menti WineList.txta fájlt http://www.cohowinery.com/downloadsC:\Documents and Settings\All Users\Documents, 500 ezredmásodperc időtúllépési időközt megadva.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Megjegyzések
Ha a célfájl már létezik, a DownloadFile metódus nem írja felül a meglévő fájlt. A metódus másik túlterhelésének egyikével DownloadFile utasíthatja a meglévő fájlok felülírására vagy egy adott időtúllépési érték megadására.
DownloadFile nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Hálózatkövetés engedélyezése.
Note
A DownloadFile metódus nem küld opcionális HTTP-fejléceket. Egyes kiszolgálók 500-et (belső kiszolgálóhibát) adhatnak vissza, ha hiányzik az opcionális felhasználói ügynök fejléce. Az opcionális fejlécek küldéséhez létre kell készítenie egy kérést az WebClient osztály használatával.
Note
Az FTP-protokoll egyszerű szövegben küld információkat, beleértve a jelszavakat is, és nem használható bizalmas információk továbbítására.
Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.Network.DownloadFile .
| Címzett | Nézze |
|---|---|
| Fájl letöltése | Útmutató: Fájl letöltése |
Lásd még
- Uri
- ICredentials
- Objects (Visual Basic)
Bemutató: Fájl letöltése Visual Basic Bemutató: Fájlelérési útvonalak elemzése a Visual Basic
A következőre érvényes:
DownloadFile(Uri, String, String, String)
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
Letölti a megadott távoli fájlt, és a megadott helyre menti.
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)
Paraméterek
- address
- Uri
A letöltendő fájl elérési útja, beleértve a fájlnevet és a gazdagép címét.
- destinationFileName
- String
A letöltött fájl neve és elérési útja.
- userName
- String
Hitelesítéshez megadott felhasználónév. Az alapértelmezett érték egy üres sztring, "".
- password
- String
Jelszó a hitelesítéshez. Az alapértelmezett érték egy üres sztring, "".
Kivételek
destinationFileName záró perjellel végződik.
A kiszolgáló nem válaszol az alapértelmezett időtúllépésen belül (100 másodperc).
A felhasználó nem rendelkezik a hálózati művelet végrehajtásához szükséges engedélyekkel.
A kérést a cél webkiszolgáló elutasítja.
Példák
Ez a példa letölti a fájlt, WineList.txt és menti a fájlba.http://www.cohowinery.com/downloadsC:\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")
Ez a példa letölti és menti WineList.txta fájlt http://www.cohowinery.com/downloadsC:\Documents and Settings\All Users\Documents, 500 ezredmásodperc időtúllépési időközt megadva.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Megjegyzések
Ha a célfájl már létezik, a DownloadFile metódus nem írja felül a meglévő fájlt. A metódus másik túlterhelésének egyikével DownloadFile utasíthatja a meglévő fájlok felülírására vagy egy adott időtúllépési érték megadására.
DownloadFile nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Hálózatkövetés engedélyezése.
Note
A DownloadFile metódus nem küld opcionális HTTP-fejléceket. Egyes kiszolgálók 500-et (belső kiszolgálóhibát) adhatnak vissza, ha hiányzik az opcionális felhasználói ügynök fejléce. Az opcionális fejlécek küldéséhez létre kell készítenie egy kérést az WebClient osztály használatával.
Note
Az FTP-protokoll egyszerű szövegben küld információkat, beleértve a jelszavakat is, és nem használható bizalmas információk továbbítására.
Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.Network.DownloadFile .
| Címzett | Nézze |
|---|---|
| Fájl letöltése | Útmutató: Fájl letöltése |
Lásd még
- Uri
- ICredentials
- Objects (Visual Basic)
Bemutató: Fájl letöltése Visual Basic Bemutató: Fájlelérési útvonalak elemzése a Visual Basic
A következőre érvényes:
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
Letölti a megadott távoli fájlt, és a megadott helyre menti.
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)
Paraméterek
- address
- Uri
String vagy Uri. A letöltendő fájl elérési útja, beleértve a fájlnevet és a gazdagép címét.
- destinationFileName
- String
String. A letöltött fájl neve és elérési útja.
- networkCredentials
- ICredentials
ICredentials. Megadandó hitelesítő adatok.
- showUI
- Boolean
True a művelet előrehaladásának megjelenítése; egyéb esetben False. Az alapértelmezett érték False.
- connectionTimeout
- Int32
Időtúllépési időköz ezredmásodpercben. Az alapértelmezett érték 100 másodperc.
- overwrite
- Boolean
True meglévő fájlok felülírása; egyéb esetben False. Az alapértelmezett érték False.
Kivételek
destinationFileName záró perjellel végződik.
overwrite értékre van állítva, False és a célfájl már létezik.
A kiszolgáló nem válaszol a megadott connectionTimeout.
A felhasználó nem rendelkezik a hálózati művelet végrehajtásához szükséges engedélyekkel.
A kérést a cél webkiszolgáló elutasítja.
Példák
Ez a példa letölti a fájlt, WineList.txt és menti a fájlba.http://www.cohowinery.com/downloadsC:\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")
Ez a példa letölti és menti WineList.txta fájlt http://www.cohowinery.com/downloadsC:\Documents and Settings\All Users\Documents, 500 ezredmásodperc időtúllépési időközt megadva.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Megjegyzések
Ha showUI be van állítva True, megjelenik egy párbeszédpanel, amely megjeleníti a művelet előrehaladását. A párbeszédpanel tartalmaz egy Mégse gombot, amely a művelet megszakításához használható. A párbeszédpanel nem modális, ezért nem blokkolja a felhasználói bevitelt a program más ablakaiba.
Ha a kiszolgáló nem válaszol a megadott connectionTimeoutterületen belül, a művelet megszakad, és kivételt okoz.
DownloadFile nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Hálózatkövetés engedélyezése.
Note
A DownloadFile metódus nem küld opcionális HTTP-fejléceket. Egyes kiszolgálók 500-et (belső kiszolgálóhibát) adhatnak vissza, ha hiányzik az opcionális felhasználói ügynök fejléce. Az opcionális fejlécek küldéséhez létre kell készítenie egy kérést az WebClient osztály használatával.
Note
Az FTP-protokoll egyszerű szövegben küld információkat, beleértve a jelszavakat is, és nem használható bizalmas információk továbbítására.
Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.Network.DownloadFile .
| Címzett | Nézze |
|---|---|
| Fájl letöltése | Útmutató: Fájl letöltése |
Lásd még
- Uri
- ICredentials
- Objects (Visual Basic)
Bemutató: Fájl letöltése Visual Basic Bemutató: Fájlelérési útvonalak elemzése a Visual Basic
A következőre érvényes:
DownloadFile(String, String, String, String, Boolean, Int32, Boolean)
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
Letölti a megadott távoli fájlt, és a megadott helyre menti.
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)
Paraméterek
- address
- String
A letöltendő fájl elérési útja, beleértve a fájlnevet és a gazdagép címét.
- destinationFileName
- String
A letöltött fájl neve és elérési útja.
- userName
- String
Hitelesítéshez megadott felhasználónév. Az alapértelmezett érték egy üres sztring, "".
- password
- String
Jelszó a hitelesítéshez. Az alapértelmezett érték egy üres sztring, "".
- showUI
- Boolean
True a művelet előrehaladásának megjelenítése; egyéb esetben False. Az alapértelmezett érték False.
- connectionTimeout
- Int32
Int32. Időtúllépési időköz ezredmásodpercben. Az alapértelmezett érték 100 másodperc.
- overwrite
- Boolean
True meglévő fájlok felülírása; egyéb esetben False. Az alapértelmezett érték False.
Kivételek
destinationFileName záró perjellel végződik.
overwrite értékre van állítva, False és a célfájl már létezik.
A kiszolgáló nem válaszol a megadott connectionTimeout.
A felhasználó nem rendelkezik a hálózati művelet végrehajtásához szükséges engedélyekkel.
A kérést a cél webkiszolgáló elutasítja.
Példák
Ez a példa letölti a fájlt, WineList.txt és menti a fájlba.http://www.cohowinery.com/downloadsC:\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")
Ez a példa letölti és menti WineList.txta fájlt http://www.cohowinery.com/downloadsC:\Documents and Settings\All Users\Documents, 500 ezredmásodperc időtúllépési időközt megadva.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Megjegyzések
Ha showUI be van állítva True, megjelenik egy párbeszédpanel, amely megjeleníti a művelet előrehaladását. A párbeszédpanel tartalmaz egy Mégse gombot, amely a művelet megszakításához használható. A párbeszédpanel nem modális, ezért nem blokkolja a felhasználói bevitelt a program más ablakaiba.
Ha a kiszolgáló nem válaszol a megadott connectionTimeoutterületen belül, a művelet megszakad, és kivételt okoz.
DownloadFile nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Hálózatkövetés engedélyezése.
Note
A DownloadFile metódus nem küld opcionális HTTP-fejléceket. Egyes kiszolgálók 500-et (belső kiszolgálóhibát) adhatnak vissza, ha hiányzik az opcionális felhasználói ügynök fejléce. Az opcionális fejlécek küldéséhez létre kell készítenie egy kérést az WebClient osztály használatával.
Note
Az FTP-protokoll egyszerű szövegben küld információkat, beleértve a jelszavakat is, és nem használható bizalmas információk továbbítására.
Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.Network.DownloadFile .
| Címzett | Nézze |
|---|---|
| Fájl letöltése | Útmutató: Fájl letöltése |
Lásd még
- Uri
- ICredentials
- Objects (Visual Basic)
Bemutató: Fájl letöltése Visual Basic Bemutató: Fájlelérési útvonalak elemzése a Visual Basic
A következőre érvényes:
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
Letölti a megadott távoli fájlt, és a megadott helyre menti.
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)
Paraméterek
- address
- Uri
A letöltendő fájl elérési útja, beleértve a fájlnevet és a gazdagép címét.
- destinationFileName
- String
A letöltött fájl neve és elérési útja.
- networkCredentials
- ICredentials
Megadandó hitelesítő adatok.
- showUI
- Boolean
True a művelet előrehaladásának megjelenítése; egyéb esetben False. Az alapértelmezett érték False.
- connectionTimeout
- Int32
Időtúllépési időköz ezredmásodpercben. Az alapértelmezett érték 100 másodperc.
- overwrite
- Boolean
True meglévő fájlok felülírása; egyéb esetben False. Az alapértelmezett érték False.
- onUserCancel
- UICancelOption
Viselkedést ad meg, ha a felhasználó a Mégse vagy a Nem gombra kattint a párbeszédpanelen, amely a beállítás értékeként showUI jelenik meg True. Az alapértelmezett érték ThrowException.
Kivételek
destinationFileName záró perjellel végződik.
overwrite értékre van állítva, False és a célfájl már létezik.
A kiszolgáló nem válaszol a megadott connectionTimeout.
A felhasználó nem rendelkezik a hálózati művelet végrehajtásához szükséges engedélyekkel.
A kérést a cél webkiszolgáló elutasítja.
Példák
Ez a példa letölti a fájlt, WineList.txt és menti a fájlba.http://www.cohowinery.com/downloadsC:\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")
Ez a példa letölti és menti WineList.txta fájlt http://www.cohowinery.com/downloadsC:\Documents and Settings\All Users\Documents, 500 ezredmásodperc időtúllépési időközt megadva.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Megjegyzések
Ha showUI be van állítva True, megjelenik egy párbeszédpanel, amely megjeleníti a művelet előrehaladását. A párbeszédpanel tartalmaz egy Mégse gombot, amely a művelet megszakításához használható. A párbeszédpanel nem modális, ezért nem blokkolja a felhasználói bevitelt a program más ablakaiba.
Ha a kiszolgáló nem válaszol a megadott connectionTimeoutterületen belül, a művelet megszakad, és kivételt okoz.
DownloadFile nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Hálózatkövetés engedélyezése.
Note
A DownloadFile metódus nem küld opcionális HTTP-fejléceket. Egyes kiszolgálók 500-et (belső kiszolgálóhibát) adhatnak vissza, ha hiányzik az opcionális felhasználói ügynök fejléce. Az opcionális fejlécek küldéséhez létre kell készítenie egy kérést az WebClient osztály használatával.
Note
Az FTP-protokoll egyszerű szövegben küld információkat, beleértve a jelszavakat is, és nem használható bizalmas információk továbbítására.
Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.Network.DownloadFile .
| Címzett | Nézze |
|---|---|
| Fájl letöltése | Útmutató: Fájl letöltése |
Lásd még
- Uri
- ICredentials
- Objects (Visual Basic)
Bemutató: Fájl letöltése Visual Basic Bemutató: Fájlelérési útvonalak elemzése a Visual Basic
A következőre érvényes:
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
Letölti a megadott távoli fájlt, és a megadott helyre menti.
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)
Paraméterek
- address
- Uri
A letöltendő fájl elérési útja, beleértve a fájlnevet és a gazdagép címét.
- destinationFileName
- String
A letöltött fájl neve és elérési útja.
- userName
- String
Hitelesítéshez megadott felhasználónév. Az alapértelmezett érték egy üres sztring, "".
- password
- String
Jelszó a hitelesítéshez. Az alapértelmezett érték egy üres sztring, "".
- showUI
- Boolean
True a művelet előrehaladásának megjelenítése; egyéb esetben False. Az alapértelmezett érték False.
- connectionTimeout
- Int32
Időtúllépési időköz ezredmásodpercben. Az alapértelmezett érték 100 másodperc.
- overwrite
- Boolean
True meglévő fájlok felülírása; egyéb esetben False. Az alapértelmezett érték False.
Kivételek
destinationFileName záró perjellel végződik.
overwrite értékre van állítva, False és a célfájl már létezik.
A kiszolgáló nem válaszol a megadott connectionTimeout.
A felhasználó nem rendelkezik a hálózati művelet végrehajtásához szükséges engedélyekkel.
A kérést a cél webkiszolgáló elutasítja.
Példák
Ez a példa letölti a fájlt, WineList.txt és menti a fájlba.http://www.cohowinery.com/downloadsC:\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")
Ez a példa letölti és menti WineList.txta fájlt http://www.cohowinery.com/downloadsC:\Documents and Settings\All Users\Documents, 500 ezredmásodperc időtúllépési időközt megadva.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Megjegyzések
Ha showUI be van állítva True, megjelenik egy párbeszédpanel, amely megjeleníti a művelet előrehaladását. A párbeszédpanel tartalmaz egy Mégse gombot, amely a művelet megszakításához használható. A párbeszédpanel nem modális, ezért nem blokkolja a felhasználói bevitelt a program más ablakaiba.
Ha a kiszolgáló nem válaszol a megadott connectionTimeoutterületen belül, a művelet megszakad, és kivételt okoz.
DownloadFile nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Hálózatkövetés engedélyezése.
Note
A DownloadFile metódus nem küld opcionális HTTP-fejléceket. Egyes kiszolgálók 500-et (belső kiszolgálóhibát) adhatnak vissza, ha hiányzik az opcionális felhasználói ügynök fejléce. Az opcionális fejlécek küldéséhez létre kell készítenie egy kérést az WebClient osztály használatával.
Note
Az FTP-protokoll egyszerű szövegben küld információkat, beleértve a jelszavakat is, és nem használható bizalmas információk továbbítására.
Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.Network.DownloadFile .
| Címzett | Nézze |
|---|---|
| Fájl letöltése | Útmutató: Fájl letöltése |
Lásd még
- Uri
- ICredentials
- Objects (Visual Basic)
Bemutató: Fájl letöltése Visual Basic Bemutató: Fájlelérési útvonalak elemzése a Visual Basic
A következőre érvényes:
DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
Letölti a megadott távoli fájlt, és a megadott helyre menti.
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)
Paraméterek
- address
- String
A letöltendő fájl elérési útja, beleértve a fájlnevet és a gazdagép címét.
- destinationFileName
- String
A letöltött fájl neve és elérési útja.
- userName
- String
Hitelesítéshez megadott felhasználónév. Az alapértelmezett érték egy üres sztring, "".
- password
- String
Jelszó a hitelesítéshez. Az alapértelmezett érték egy üres sztring, "".
- showUI
- Boolean
True a művelet előrehaladásának megjelenítése; egyéb esetben False. Az alapértelmezett érték False.
- connectionTimeout
- Int32
Időtúllépési időköz ezredmásodpercben. Az alapértelmezett érték 100 másodperc.
- overwrite
- Boolean
True meglévő fájlok felülírása; egyéb esetben False. Az alapértelmezett érték False.
- onUserCancel
- UICancelOption
Viselkedést ad meg, ha a felhasználó a Mégse vagy a Nem gombra kattint a párbeszédpanelen, amely a beállítás értékeként ShowUI jelenik meg True. Az alapértelmezett érték ThrowException.
Kivételek
destinationFileName záró perjellel végződik.
overwrite értékre van állítva, False és a célfájl már létezik.
A kiszolgáló nem válaszol a megadott connectionTimeout.
A felhasználó nem rendelkezik a hálózati művelet végrehajtásához szükséges engedélyekkel.
A kérést a cél webkiszolgáló elutasítja.
Példák
Ez a példa letölti a fájlt, WineList.txt és menti a fájlba.http://www.cohowinery.com/downloadsC:\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")
Ez a példa letölti és menti WineList.txta fájlt http://www.cohowinery.com/downloadsC:\Documents and Settings\All Users\Documents, 500 ezredmásodperc időtúllépési időközt megadva.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Megjegyzések
Ha showUI be van állítva True, megjelenik egy párbeszédpanel, amely megjeleníti a művelet előrehaladását. A párbeszédpanel tartalmaz egy Mégse gombot, amely a művelet megszakításához használható. A párbeszédpanel nem modális, ezért nem blokkolja a felhasználói bevitelt a program más ablakaiba.
Ha a kiszolgáló nem válaszol a megadott connectionTimeoutterületen belül, a művelet megszakad, és kivételt okoz.
DownloadFile nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Hálózatkövetés engedélyezése.
Note
A DownloadFile metódus nem küld opcionális HTTP-fejléceket. Egyes kiszolgálók 500-et (belső kiszolgálóhibát) adhatnak vissza, ha hiányzik az opcionális felhasználói ügynök fejléce. Az opcionális fejlécek küldéséhez létre kell készítenie egy kérést az WebClient osztály használatával.
Note
Az FTP-protokoll egyszerű szövegben küld információkat, beleértve a jelszavakat is, és nem használható bizalmas információk továbbítására.
Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.Network.DownloadFile .
| Címzett | Nézze |
|---|---|
| Fájl letöltése | Útmutató: Fájl letöltése |
Lásd még
- Uri
- ICredentials
- Objects (Visual Basic)
Bemutató: Fájl letöltése Visual Basic Bemutató: Fájlelérési útvonalak elemzése a Visual Basic
A következőre érvényes:
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.DownloadFile.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
- Forrás:
- Network.vb
Letölti a megadott távoli fájlt, és a megadott helyre menti.
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)
Paraméterek
- address
- Uri
A letöltendő fájl elérési útja, beleértve a fájlnevet és a gazdagép címét.
- destinationFileName
- String
A letöltött fájl neve és elérési útja.
- userName
- String
Hitelesítéshez megadott felhasználónév. Az alapértelmezett érték egy üres sztring, "".
- password
- String
Jelszó a hitelesítéshez. Az alapértelmezett érték egy üres sztring, "".
- showUI
- Boolean
True a művelet előrehaladásának megjelenítése; egyéb esetben False. Az alapértelmezett érték False.
- connectionTimeout
- Int32
Időtúllépési időköz ezredmásodpercben. Az alapértelmezett érték 100 másodperc.
- overwrite
- Boolean
True meglévő fájlok felülírása; egyéb esetben False. Az alapértelmezett érték False.
- onUserCancel
- UICancelOption
Viselkedést ad meg, ha a felhasználó a Mégse vagy a Nem gombra kattint a párbeszédpanelen, amely a beállítás értékeként ShowUI jelenik meg True. Az alapértelmezett érték ThrowException.
Kivételek
destinationFileName záró perjellel végződik.
overwrite értékre van állítva, False és a célfájl már létezik.
A kiszolgáló nem válaszol a megadott connectionTimeout.
A felhasználó nem rendelkezik a hálózati művelet végrehajtásához szükséges engedélyekkel.
A kérést a cél webkiszolgáló elutasítja.
Példák
Ez a példa letölti a fájlt, WineList.txt és menti a fájlba.http://www.cohowinery.com/downloadsC:\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")
Ez a példa letölti és menti WineList.txta fájlt http://www.cohowinery.com/downloadsC:\Documents and Settings\All Users\Documents, 500 ezredmásodperc időtúllépési időközt megadva.
My.Computer.Network.DownloadFile(
"http://www.cohowinery.com/downloads/",
"C:\Documents and Settings\All Users\Documents\WineList.txt",
"", "", False, 500, True)
Megjegyzések
Ha showUI be van állítva True, megjelenik egy párbeszédpanel, amely megjeleníti a művelet előrehaladását. A párbeszédpanel tartalmaz egy Mégse gombot, amely a művelet megszakításához használható. A párbeszédpanel nem modális, ezért nem blokkolja a felhasználói bevitelt a program más ablakaiba.
Ha a kiszolgáló nem válaszol a megadott connectionTimeoutterületen belül, a művelet megszakad, és kivételt okoz.
DownloadFile nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Hálózatkövetés engedélyezése.
Note
A DownloadFile metódus nem küld opcionális HTTP-fejléceket. Egyes kiszolgálók 500-et (belső kiszolgálóhibát) adhatnak vissza, ha hiányzik az opcionális felhasználói ügynök fejléce. Az opcionális fejlécek küldéséhez létre kell készítenie egy kérést az WebClient osztály használatával.
Note
Az FTP-protokoll egyszerű szövegben küld információkat, beleértve a jelszavakat is, és nem használható bizalmas információk továbbítására.
Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.Network.DownloadFile .
| Címzett | Nézze |
|---|---|
| Fájl letöltése | Útmutató: Fájl letöltése |
Lásd még
- Uri
- ICredentials
- Objects (Visual Basic)
Bemutató: Fájl letöltése Visual Basic Bemutató: Fájlelérési útvonalak elemzése a Visual Basic