Network.DownloadFile Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic.Devices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.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

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

Der Pfad der Datei, die heruntergeladen werden soll, einschließlich des Dateinamens und der 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

Einem Benutzer fehlen notwendige Berechtigungen, um eine Netzwerkoperation auszuführen.

WebException

Die Anforderung wurde vom Zielwebserver abgelehnt.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und in C:\Documents and Settings\All Users\Documentsgespeichert.

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 in C:\Documents and Settings\All Users\Documentsgespeichert, wobei ein Timeoutintervall von 500 Millisekunden angegeben wird.

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.

Hinweis

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. Zum Senden optionaler Header müssen Sie eine Anforderung mit 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.

Beschreibung	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

Der Pfad der Datei, die heruntergeladen werden soll, einschließlich des Dateinamens und der 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

Einem Benutzer fehlen notwendige Berechtigungen, um eine Netzwerkoperation auszuführen.

WebException

Die Anforderung wurde vom Zielwebserver abgelehnt.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und in C:\Documents and Settings\All Users\Documentsgespeichert.

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 DownloadFile -Methode die 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.

Hinweis

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

Beschreibung	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

Der Pfad der Datei, die heruntergeladen werden soll, einschließlich des Dateinamens und der Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

userName: String

Benutzername, der authentifiziert werden soll. Der Standardwert ist eine leere Zeichenfolge ("").

password: String

Das zu authentifizierende Kennwort. 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

Einem Benutzer fehlen notwendige Berechtigungen, um eine Netzwerkoperation auszuführen.

WebException

Die Anforderung wurde vom Zielwebserver abgelehnt.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und in C:\Documents and Settings\All Users\Documentsgespeichert.

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 DownloadFile -Methode die vorhandene Datei nicht. Sie können eine der anderen Überladungen der -Methode verwenden, um sie DownloadFile anzuweisen, vorhandene Dateien zu überschreiben oder einen bestimmten Timeoutwert anzugeben.

Hinweis

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, in Nur-Text und sollte nicht für die Übermittlung 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.

Beschreibung	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

Der Pfad der Datei, die heruntergeladen werden soll, einschließlich des Dateinamens und der Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

userName: String

Benutzername, der authentifiziert werden soll. Der Standardwert ist eine leere Zeichenfolge ("").

password: String

Das zu authentifizierende Kennwort. 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

Einem Benutzer fehlen notwendige Berechtigungen, um eine Netzwerkoperation auszuführen.

WebException

Die Anforderung wurde vom Zielwebserver abgelehnt.

Beispiele

In diesem Beispiel wird die Datei WineList.txt aus http://www.cohowinery.com/downloads heruntergeladen und in C:\Documents and Settings\All Users\Documentsgespeichert.

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 aus http://www.cohowinery.com/downloads heruntergeladen und in C:\Documents and Settings\All Users\Documentsgespeichert, wobei ein Timeoutintervall von 500 Millisekunden angegeben wird.

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

Hinweise

Hinweis

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 mit der WebClient -Klasse erstellen.

Hinweis

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, als 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.

Beschreibung	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. Der Pfad der Datei, die heruntergeladen werden soll, einschließlich des Dateinamens und der Hostadresse.

destinationFileName: String

String. Dateiname und Pfad der heruntergeladenen Datei.

networkCredentials: ICredentials

ICredentials. Die anzugebenden Anmeldeinformationen.

showUI: Boolean

True, wenn der Status des Vorgangs angezeigt werden soll, andernfalls False. Der Standardwert ist False.

connectionTimeout: Int32

Timeoutintervall in Millisekunden. Der Standardwert beträgt 100 Sekunden.

overwrite: Boolean

True, wenn vorhandene Dateien überschrieben werden sollen, andernfalls False. Der Standardwert ist False.

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

IOException

overwrite ist auf False festgelegt, und die Zieldatei ist bereits vorhanden.

TimeoutException

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

SecurityException

Einem Benutzer fehlen notwendige Berechtigungen, um eine Netzwerkoperation auszuführen.

WebException

Die Anforderung wurde vom Zielwebserver abgelehnt.

Beispiele

In diesem Beispiel wird die Datei WineList.txt aus http://www.cohowinery.com/downloads heruntergeladen und in C:\Documents and Settings\All Users\Documentsgespeichert.

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 showUI auf Truefestgelegt ist, wird ein Dialogfeld angezeigt, das den Fortschritt des Vorgangs anzeigt. 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 connectionTimeoutantwortet, wird der Vorgang abgebrochen, und es wird eine Ausnahme ausgelöst.

Hinweis

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, als 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.

Beschreibung	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

Der Pfad der Datei, die heruntergeladen werden soll, einschließlich des Dateinamens und der Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

userName: String

Benutzername, der authentifiziert werden soll. Der Standardwert ist eine leere Zeichenfolge ("").

password: String

Das zu authentifizierende Kennwort. Der Standardwert ist eine leere Zeichenfolge ("").

showUI: Boolean

True, wenn der Status des Vorgangs angezeigt werden soll, andernfalls False. Der Standardwert ist False.

connectionTimeout: Int32

Int32. Timeoutintervall in Millisekunden. Der Standardwert beträgt 100 Sekunden.

overwrite: Boolean

True, wenn vorhandene Dateien überschrieben werden sollen, andernfalls False. Der Standardwert ist False.

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

IOException

overwrite ist auf False festgelegt, und die Zieldatei ist bereits vorhanden.

TimeoutException

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

SecurityException

Einem Benutzer fehlen notwendige Berechtigungen, um eine Netzwerkoperation auszuführen.

WebException

Die Anforderung wurde vom Zielwebserver abgelehnt.

Beispiele

In diesem Beispiel wird die Datei WineList.txt aus http://www.cohowinery.com/downloads heruntergeladen und in C:\Documents and Settings\All Users\Documentsgespeichert.

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 connectionTimeoutantwortet, wird der Vorgang abgebrochen, und es wird eine Ausnahme ausgelöst.

Hinweis

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, in Nur-Text und sollte nicht für die Übermittlung 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.

Beschreibung	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

Der Pfad der Datei, die heruntergeladen werden soll, einschließlich des Dateinamens und der Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

networkCredentials: ICredentials

Die anzugebenden Anmeldeinformationen.

showUI: Boolean

True, wenn der Status des Vorgangs angezeigt werden soll, andernfalls False. Der Standardwert ist False.

connectionTimeout: Int32

Timeoutintervall in Millisekunden. Der Standardwert beträgt 100 Sekunden.

overwrite: Boolean

True, wenn vorhandene Dateien überschrieben werden sollen, andernfalls False. Der Standardwert ist False.

onUserCancel: UICancelOption

Gibt das Verhalten beim Klicken auf Abbrechen oder Nein in dem Dialogfeld an, das angezeigt wird, wenn showUI auf True festgelegt ist. Der Standardwert ist ThrowException.

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

IOException

overwrite ist auf False festgelegt, und die Zieldatei ist bereits vorhanden.

TimeoutException

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

SecurityException

Einem Benutzer fehlen notwendige Berechtigungen, um eine Netzwerkoperation auszuführen.

WebException

Die Anforderung wurde vom Zielwebserver abgelehnt.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und in C:\Documents and Settings\All Users\Documentsgespeichert.

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 showUI auf Truefestgelegt ist, wird ein Dialogfeld angezeigt, das den Fortschritt des Vorgangs anzeigt. 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 innerhalb des angegebenen connectionTimeoutnicht antwortet, wird der Vorgang abgebrochen, und es wird eine Ausnahme ausgelöst.

Hinweis

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, in Nur-Text und sollte nicht für die Übermittlung 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.

Beschreibung	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

Der Pfad der Datei, die heruntergeladen werden soll, einschließlich des Dateinamens und der Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

userName: String

Benutzername, der authentifiziert werden soll. Der Standardwert ist eine leere Zeichenfolge ("").

password: String

Das zu authentifizierende Kennwort. Der Standardwert ist eine leere Zeichenfolge ("").

showUI: Boolean

True, wenn der Status des Vorgangs angezeigt werden soll, andernfalls False. Der Standardwert ist False.

connectionTimeout: Int32

Timeoutintervall in Millisekunden. Der Standardwert beträgt 100 Sekunden.

overwrite: Boolean

True, wenn vorhandene Dateien überschrieben werden sollen, andernfalls False. Der Standardwert ist False.

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

IOException

overwrite ist auf False festgelegt, und die Zieldatei ist bereits vorhanden.

TimeoutException

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

SecurityException

Einem Benutzer fehlen notwendige Berechtigungen, um eine Netzwerkoperation auszuführen.

WebException

Die Anforderung wurde vom Zielwebserver abgelehnt.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und in C:\Documents and Settings\All Users\Documentsgespeichert.

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 innerhalb des angegebenen connectionTimeoutnicht antwortet, wird der Vorgang abgebrochen, und es wird eine Ausnahme ausgelöst.

Hinweis

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, in Nur-Text und sollte nicht für die Übermittlung 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.

Beschreibung	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

Der Pfad der Datei, die heruntergeladen werden soll, einschließlich des Dateinamens und der Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

userName: String

Benutzername, der authentifiziert werden soll. Der Standardwert ist eine leere Zeichenfolge ("").

password: String

Das zu authentifizierende Kennwort. Der Standardwert ist eine leere Zeichenfolge ("").

showUI: Boolean

True, wenn der Status des Vorgangs angezeigt werden soll, andernfalls False. Der Standardwert ist False.

connectionTimeout: Int32

Timeoutintervall in Millisekunden. Der Standardwert beträgt 100 Sekunden.

overwrite: Boolean

True, wenn vorhandene Dateien überschrieben werden sollen, andernfalls False. Der Standardwert ist False.

onUserCancel: UICancelOption

Gibt das Verhalten beim Klicken auf Abbrechen oder Nein in dem Dialogfeld an, das angezeigt wird, wenn ShowUI auf True festgelegt ist. Der Standardwert ist ThrowException.

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

IOException

overwrite ist auf False festgelegt, und die Zieldatei ist bereits vorhanden.

TimeoutException

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

SecurityException

Einem Benutzer fehlen notwendige Berechtigungen, um eine Netzwerkoperation auszuführen.

WebException

Die Anforderung wurde vom Zielwebserver abgelehnt.

Beispiele

In diesem Beispiel wird die Datei WineList.txt heruntergeladen http://www.cohowinery.com/downloads und in C:\Documents and Settings\All Users\Documentsgespeichert.

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 connectionTimeoutantwortet, wird der Vorgang abgebrochen, und es wird eine Ausnahme ausgelöst.

Hinweis

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, als 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.

Beschreibung	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

Der Pfad der Datei, die heruntergeladen werden soll, einschließlich des Dateinamens und der Hostadresse.

destinationFileName: String

Dateiname und Pfad der heruntergeladenen Datei.

userName: String

Benutzername, der authentifiziert werden soll. Der Standardwert ist eine leere Zeichenfolge ("").

password: String

Das zu authentifizierende Kennwort. Der Standardwert ist eine leere Zeichenfolge ("").

showUI: Boolean

True, wenn der Status des Vorgangs angezeigt werden soll, andernfalls False. Der Standardwert ist False.

connectionTimeout: Int32

Timeoutintervall in Millisekunden. Der Standardwert beträgt 100 Sekunden.

overwrite: Boolean

True, wenn vorhandene Dateien überschrieben werden sollen, andernfalls False. Der Standardwert ist False.

onUserCancel: UICancelOption

Gibt das Verhalten beim Klicken auf Abbrechen oder Nein in dem Dialogfeld an, das angezeigt wird, wenn ShowUI auf True festgelegt ist. Der Standardwert ist ThrowException.

Ausnahmen

ArgumentException

destinationFileName endet mit einem nachgestellten Schrägstrich.

IOException

overwrite ist auf False festgelegt, und die Zieldatei ist bereits vorhanden.

TimeoutException

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

SecurityException

Einem Benutzer fehlen notwendige Berechtigungen, um eine Netzwerkoperation auszuführen.

WebException

Die Anforderung wurde vom Zielwebserver abgelehnt.

Beispiele

In diesem Beispiel wird die Datei WineList.txt aus http://www.cohowinery.com/downloads heruntergeladen und in C:\Documents and Settings\All Users\Documentsgespeichert.

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 connectionTimeoutantwortet, wird der Vorgang abgebrochen, und es wird eine Ausnahme ausgelöst.

Hinweis

Das FTP-Protokoll sendet Informationen, einschließlich Kennwörtern, als 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.

Beschreibung	Siehe
Herunterladen einer Datei	Vorgehensweise: Herunterladen einer Datei

Weitere Informationen

Gilt für:

Teilen über

Network.DownloadFile Methode

Definition

Überlädt

DownloadFile(String, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

DownloadFile(Uri, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

DownloadFile(String, String, String, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

DownloadFile(Uri, String, String, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen