Network.DownloadFile Methode
Definition
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
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
- Uri
- ICredentials
- Objekte (Visual Basic)
- Gewusst wie: Downloaden einer Datei in Visual Basic
- Gewusst wie: Analysieren von Dateipfaden in Visual Basic
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
- Uri
- ICredentials
- Objekte (Visual Basic)
- Gewusst wie: Downloaden einer Datei in Visual Basic
- Gewusst wie: Analysieren von Dateipfaden in Visual Basic
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
- Uri
- ICredentials
- Objekte (Visual Basic)
- Gewusst wie: Downloaden einer Datei in Visual Basic
- Gewusst wie: Analysieren von Dateipfaden in Visual Basic
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
- Uri
- ICredentials
- Objekte (Visual Basic)
- Gewusst wie: Downloaden einer Datei in Visual Basic
- Gewusst wie: Analysieren von Dateipfaden in Visual Basic
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
- Uri
- ICredentials
- Objekte (Visual Basic)
- Gewusst wie: Downloaden einer Datei in Visual Basic
- Gewusst wie: Analysieren von Dateipfaden in Visual Basic
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
- Uri
- ICredentials
- Objekte (Visual Basic)
- Gewusst wie: Downloaden einer Datei in Visual Basic
- Gewusst wie: Analysieren von Dateipfaden in Visual Basic
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
- Uri
- ICredentials
- Objekte (Visual Basic)
- Gewusst wie: Downloaden einer Datei in Visual Basic
- Gewusst wie: Analysieren von Dateipfaden in Visual Basic
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
- Uri
- ICredentials
- Objekte (Visual Basic)
- Gewusst wie: Downloaden einer Datei in Visual Basic
- Gewusst wie: Analysieren von Dateipfaden in Visual Basic
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
- Uri
- ICredentials
- Objekte (Visual Basic)
- Gewusst wie: Downloaden einer Datei in Visual Basic
- Gewusst wie: Analysieren von Dateipfaden in Visual Basic
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
- Uri
- ICredentials
- Objekte (Visual Basic)
- Gewusst wie: Downloaden einer Datei in Visual Basic
- Gewusst wie: Analysieren von Dateipfaden in Visual Basic