Network.DownloadFile Methode

Definition

Namespace:: Microsoft.VisualBasic.Devices

Assembly:: Microsoft.VisualBasic.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.

Überlädt

Name	Beschreibung
DownloadFile(String, String)	Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.
DownloadFile(Uri, String)	Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.
DownloadFile(String, String, String, String)	Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.
DownloadFile(Uri, String, String, String)	Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)	Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean)	Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)	Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)	Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.
DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)	Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.

DownloadFile(String, String)

Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.

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)

Parameter

address: String

Pfad der herunterzuladenden Datei, einschließlich Dateiname und Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

TimeoutException

Der Server antwortet nicht innerhalb des Standardtimeouts (100 Sekunden).

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Ausführen eines Netzwerkvorgangs.

WebException

Die Anforderung wird vom Zielwebserver verweigert.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und gespeichert.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")

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und gespeichert C:\Documents and Settings\All Users\Documents. Dabei wird ein Timeoutintervall von 500 Millisekunden angegeben.

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

Hinweise

DownloadFile gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Aktivieren der Netzwerkablaufverfolgung.

Note

Die DownloadFile Methode sendet keine optionalen HTTP-Header. Einige Server geben möglicherweise 500 (Interner Serverfehler) zurück, wenn der optionale Benutzer-Agent-Header fehlt. Um optionale Header zu senden, müssen Sie eine Anforderung mithilfe der WebClient Klasse erstellen.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.Network.DownloadFile Methode umfasst.

To	Siehe
Herunterladen einer Datei	Vorgehensweise: Herunterladen einer Datei

Weitere Informationen

Gilt für:

DownloadFile(Uri, String)

Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.

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)

Parameter

address: Uri

Pfad der herunterzuladenden Datei, einschließlich Dateiname und Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

TimeoutException

Der Server antwortet nicht innerhalb des Standardtimeouts (100 Sekunden).

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Ausführen eines Netzwerkvorgangs.

WebException

Die Anforderung wird vom Zielwebserver verweigert.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und gespeichert.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")

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

Hinweise

Wenn die Zieldatei bereits vorhanden ist, überschreibt die Methode die DownloadFile vorhandene Datei nicht. Sie können eine der anderen Überladungen der DownloadFile Methode verwenden, um sie anzuweisen, vorhandene Dateien zu überschreiben, Benutzeranmeldeinformationen bereitzustellen oder einen bestimmten Timeoutwert anzugeben. DownloadFile gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Aktivieren der Netzwerkablaufverfolgung.

Note

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.Network.DownloadFile Methode umfasst.

To	Siehe
Herunterladen einer Datei	Vorgehensweise: Herunterladen einer Datei

Weitere Informationen

Gilt für:

DownloadFile(String, String, String, String)

Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.

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)

Parameter

address: String

Pfad der herunterzuladenden Datei, einschließlich Dateiname und Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

userName: String

Benutzername für die Authentifizierung. Der Standardwert ist eine leere Zeichenfolge "".

password: String

Kennwort für die Authentifizierung. Der Standardwert ist eine leere Zeichenfolge "".

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

TimeoutException

Der Server antwortet nicht innerhalb des Standardtimeouts (100 Sekunden).

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Ausführen eines Netzwerkvorgangs.

WebException

Die Anforderung wird vom Zielwebserver verweigert.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und gespeichert.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")

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

Hinweise

Note

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, in Nur-Text und sollte nicht für die Übertragung vertraulicher Informationen verwendet werden.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.Network.DownloadFile Methode umfasst.

To	Siehe
Herunterladen einer Datei	Vorgehensweise: Herunterladen einer Datei

Weitere Informationen

Gilt für:

DownloadFile(Uri, String, String, String)

Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.

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)

Parameter

address: Uri

Pfad der herunterzuladenden Datei, einschließlich Dateiname und Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

userName: String

Benutzername für die Authentifizierung. Der Standardwert ist eine leere Zeichenfolge "".

password: String

Kennwort für die Authentifizierung. Der Standardwert ist eine leere Zeichenfolge "".

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

TimeoutException

Der Server antwortet nicht innerhalb des Standardtimeouts (100 Sekunden).

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Ausführen eines Netzwerkvorgangs.

WebException

Die Anforderung wird vom Zielwebserver verweigert.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und gespeichert.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")

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

Hinweise

Note

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, in Nur-Text und sollte nicht für die Übertragung vertraulicher Informationen verwendet werden.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.Network.DownloadFile Methode umfasst.

To	Siehe
Herunterladen einer Datei	Vorgehensweise: Herunterladen einer Datei

Weitere Informationen

Gilt für:

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

Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.

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)

Parameter

address: Uri

String oder Uri. Pfad der herunterzuladenden Datei, einschließlich Dateiname und Hostadresse.

destinationFileName: String

String. Dateiname und Pfad der heruntergeladenen Datei.

networkCredentials: ICredentials

ICredentials. Zu gebende Anmeldeinformationen an.

showUI: Boolean

True um den Fortschritt des Vorgangs anzuzeigen; andernfalls False. Der Standardwert ist False.

connectionTimeout: Int32

Timeoutintervall in Millisekunden. Der Standardwert ist 100 Sekunden.

overwrite: Boolean

True vorhandene Dateien zu überschreiben; andernfalls False. Der Standardwert ist False.

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

IOException

overwrite ist auf False und die Zieldatei ist bereits vorhanden.

TimeoutException

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Ausführen eines Netzwerkvorgangs.

WebException

Die Anforderung wird vom Zielwebserver verweigert.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und gespeichert.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")

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

Hinweise

Wenn dieser Wert auf showUI festgelegt Trueist, wird ein Dialogfeld angezeigt, in dem der Fortschritt des Vorgangs angezeigt wird. Das Dialogfeld enthält eine Schaltfläche "Abbrechen ", die zum Abbrechen des Vorgangs verwendet werden kann. Das Dialogfeld ist nicht modal und blockiert daher keine Benutzereingaben für andere Fenster im Programm.

Wenn der Server nicht innerhalb des angegebenen connectionTimeoutAntwortvorgangs reagiert, wird der Vorgang abgebrochen und eine Ausnahme ausgelöst.

Note

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, in Nur-Text und sollte nicht für die Übertragung vertraulicher Informationen verwendet werden.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.Network.DownloadFile Methode umfasst.

To	Siehe
Herunterladen einer Datei	Vorgehensweise: Herunterladen einer Datei

Weitere Informationen

Gilt für:

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

Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.

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)

Parameter

address: String

Pfad der herunterzuladenden Datei, einschließlich Dateiname und Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

userName: String

Benutzername für die Authentifizierung. Der Standardwert ist eine leere Zeichenfolge "".

password: String

Kennwort für die Authentifizierung. Der Standardwert ist eine leere Zeichenfolge "".

showUI: Boolean

True um den Fortschritt des Vorgangs anzuzeigen; andernfalls False. Der Standardwert ist False.

connectionTimeout: Int32

Int32. Timeoutintervall in Millisekunden. Der Standardwert ist 100 Sekunden.

overwrite: Boolean

True vorhandene Dateien zu überschreiben; andernfalls False. Der Standardwert ist False.

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

IOException

overwrite ist auf False und die Zieldatei ist bereits vorhanden.

TimeoutException

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Ausführen eines Netzwerkvorgangs.

WebException

Die Anforderung wird vom Zielwebserver verweigert.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und gespeichert.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")

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

Hinweise

Wenn der Server nicht innerhalb des angegebenen connectionTimeoutAntwortvorgangs reagiert, wird der Vorgang abgebrochen und eine Ausnahme ausgelöst.

Note

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, in Nur-Text und sollte nicht für die Übertragung vertraulicher Informationen verwendet werden.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.Network.DownloadFile Methode umfasst.

To	Siehe
Herunterladen einer Datei	Vorgehensweise: Herunterladen einer Datei

Weitere Informationen

Gilt für:

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

Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.

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)

Parameter

address: Uri

Pfad der herunterzuladenden Datei, einschließlich Dateiname und Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

networkCredentials: ICredentials

Zu gebende Anmeldeinformationen an.

showUI: Boolean

True um den Fortschritt des Vorgangs anzuzeigen; andernfalls False. Der Standardwert ist False.

connectionTimeout: Int32

Timeoutintervall in Millisekunden. Der Standardwert ist 100 Sekunden.

overwrite: Boolean

True vorhandene Dateien zu überschreiben; andernfalls False. Der Standardwert ist False.

onUserCancel: UICancelOption

Gibt das Verhalten an, wenn der Benutzer im Dialogfeld auf "Abbrechen " oder "Nein " klickt, das als Ergebnis des showUI Satzes angezeigt Truewird. Der Standardwert ist ThrowException.

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

IOException

overwrite ist auf False und die Zieldatei ist bereits vorhanden.

TimeoutException

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Ausführen eines Netzwerkvorgangs.

WebException

Die Anforderung wird vom Zielwebserver verweigert.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und gespeichert.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")

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

Hinweise

Wenn der Server nicht innerhalb des angegebenen connectionTimeoutAntwortvorgangs reagiert, wird der Vorgang abgebrochen und eine Ausnahme ausgelöst.

Note

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, in Nur-Text und sollte nicht für die Übertragung vertraulicher Informationen verwendet werden.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.Network.DownloadFile Methode umfasst.

To	Siehe
Herunterladen einer Datei	Vorgehensweise: Herunterladen einer Datei

Weitere Informationen

Gilt für:

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

Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.

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)

Parameter

address: Uri

Pfad der herunterzuladenden Datei, einschließlich Dateiname und Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

userName: String

Benutzername für die Authentifizierung. Der Standardwert ist eine leere Zeichenfolge "".

password: String

Kennwort für die Authentifizierung. Der Standardwert ist eine leere Zeichenfolge "".

showUI: Boolean

True um den Fortschritt des Vorgangs anzuzeigen; andernfalls False. Der Standardwert ist False.

connectionTimeout: Int32

Timeoutintervall in Millisekunden. Der Standardwert ist 100 Sekunden.

overwrite: Boolean

True vorhandene Dateien zu überschreiben; andernfalls False. Der Standardwert ist False.

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

IOException

overwrite ist auf False und die Zieldatei ist bereits vorhanden.

TimeoutException

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Ausführen eines Netzwerkvorgangs.

WebException

Die Anforderung wird vom Zielwebserver verweigert.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und gespeichert.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")

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

Hinweise

Wenn der Server nicht innerhalb des angegebenen connectionTimeoutAntwortvorgangs reagiert, wird der Vorgang abgebrochen und eine Ausnahme ausgelöst.

Note

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, in Nur-Text und sollte nicht für die Übertragung vertraulicher Informationen verwendet werden.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.Network.DownloadFile Methode umfasst.

To	Siehe
Herunterladen einer Datei	Vorgehensweise: Herunterladen einer Datei

Weitere Informationen

Gilt für:

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

Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.

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)

Parameter

address: String

Pfad der herunterzuladenden Datei, einschließlich Dateiname und Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

userName: String

Benutzername für die Authentifizierung. Der Standardwert ist eine leere Zeichenfolge "".

password: String

Kennwort für die Authentifizierung. Der Standardwert ist eine leere Zeichenfolge "".

showUI: Boolean

True um den Fortschritt des Vorgangs anzuzeigen; andernfalls False. Der Standardwert ist False.

connectionTimeout: Int32

Timeoutintervall in Millisekunden. Der Standardwert ist 100 Sekunden.

overwrite: Boolean

True vorhandene Dateien zu überschreiben; andernfalls False. Der Standardwert ist False.

onUserCancel: UICancelOption

Gibt das Verhalten an, wenn der Benutzer im Dialogfeld auf "Abbrechen " oder "Nein " klickt, das als Ergebnis des ShowUI Satzes angezeigt Truewird. Der Standardwert ist ThrowException.

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

IOException

overwrite ist auf False und die Zieldatei ist bereits vorhanden.

TimeoutException

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Ausführen eines Netzwerkvorgangs.

WebException

Die Anforderung wird vom Zielwebserver verweigert.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und gespeichert.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")

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

Hinweise

Wenn der Server nicht innerhalb des angegebenen connectionTimeoutAntwortvorgangs reagiert, wird der Vorgang abgebrochen und eine Ausnahme ausgelöst.

Note

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, in Nur-Text und sollte nicht für die Übertragung vertraulicher Informationen verwendet werden.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.Network.DownloadFile Methode umfasst.

To	Siehe
Herunterladen einer Datei	Vorgehensweise: Herunterladen einer Datei

Weitere Informationen

Gilt für:

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

Lädt die angegebene Remotedatei herunter und speichert sie am angegebenen Speicherort.

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)

Parameter

address: Uri

Pfad der herunterzuladenden Datei, einschließlich Dateiname und Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

userName: String

Benutzername für die Authentifizierung. Der Standardwert ist eine leere Zeichenfolge "".

password: String

Kennwort für die Authentifizierung. Der Standardwert ist eine leere Zeichenfolge "".

showUI: Boolean

True um den Fortschritt des Vorgangs anzuzeigen; andernfalls False. Der Standardwert ist False.

connectionTimeout: Int32

Timeoutintervall in Millisekunden. Der Standardwert ist 100 Sekunden.

overwrite: Boolean

True vorhandene Dateien zu überschreiben; andernfalls False. Der Standardwert ist False.

onUserCancel: UICancelOption

Gibt das Verhalten an, wenn der Benutzer im Dialogfeld auf "Abbrechen " oder "Nein " klickt, das als Ergebnis des ShowUI Satzes angezeigt Truewird. Der Standardwert ist ThrowException.

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

IOException

overwrite ist auf False und die Zieldatei ist bereits vorhanden.

TimeoutException

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Ausführen eines Netzwerkvorgangs.

WebException

Die Anforderung wird vom Zielwebserver verweigert.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und gespeichert.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")

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

Hinweise

Wenn der Server nicht innerhalb des angegebenen connectionTimeoutAntwortvorgangs reagiert, wird der Vorgang abgebrochen und eine Ausnahme ausgelöst.

Note

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, in Nur-Text und sollte nicht für die Übertragung vertraulicher Informationen verwendet werden.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.Network.DownloadFile Methode umfasst.

To	Siehe
Herunterladen einer Datei	Vorgehensweise: Herunterladen einer Datei

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?