Freigeben über


Network.DownloadFile Methode

Definition

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

destinationFileName endet mit einem nachgestellten Schrägstrich.

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

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

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

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

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

destinationFileName endet mit einem nachgestellten Schrägstrich.

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

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

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

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

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

destinationFileName endet mit einem nachgestellten Schrägstrich.

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

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

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

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.

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.

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

destinationFileName endet mit einem nachgestellten Schrägstrich.

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

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

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

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

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

destinationFileName endet mit einem nachgestellten Schrägstrich.

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

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

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

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

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.

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. 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(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

destinationFileName endet mit einem nachgestellten Schrägstrich.

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

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

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

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

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.

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. 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, 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

destinationFileName endet mit einem nachgestellten Schrägstrich.

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

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

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

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

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.

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.

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

destinationFileName endet mit einem nachgestellten Schrägstrich.

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

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

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

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

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.

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.

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

destinationFileName endet mit einem nachgestellten Schrägstrich.

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

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

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

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

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.

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. 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, 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

destinationFileName endet mit einem nachgestellten Schrägstrich.

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

Der Server antwortet nicht innerhalb des angegebenen connectionTimeout.

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

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

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.

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. 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: