My.Computer.Network.DownloadFile-Methode

Aktualisiert: November 2007

Downloadet die angegebene Remotedatei und speichert sie am angegebenen Speicherort.

' Usage
My.Computer.Network.DownloadFile(address ,destinationFileName)
My.Computer.Network.DownloadFile(address ,destinationFileName)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password ,showUI ,connectionTimeout ,overwrite)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password ,showUI ,connectionTimeout ,overwrite ,onUserCancel)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password ,showUI ,connectionTimeout ,overwrite)
My.Computer.Network.DownloadFile(address ,destinationFileName ,userName ,password ,showUI ,connectionTimeout ,overwrite ,onUserCancel)
My.Computer.Network.DownloadFile(address ,destinationFileName ,networkCredentials ,showUI ,connectionTimeout ,overwrite)
My.Computer.Network.DownloadFile(address ,destinationFileName ,networkCredentials ,showUI ,connectionTimeout ,overwrite ,onUserCancel)
' Declaration
Public Sub DownloadFile( _
   ByVal address As String, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As String, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As String, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As String, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean, _
   ByVal onUserCancel As UICancelOption _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean, _
   ByVal onUserCancel As UICancelOption _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal networkCredentials As System.Net.ICredentials, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub DownloadFile( _
   ByVal address As System.Uri, _
   ByVal destinationFileName As String, _
   ByVal networkCredentials As System.Net.ICredentials, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal overwrite As Boolean, _
   ByVal onUserCancel As UICancelOption _
)

Parameter

• address
  String oder Uri. Pfad der Datei, die gedownloadet werden soll, einschließlich des Dateinamens und der Hostadresse. Erforderlich.

• destinationFileName
  String. Dateiname und Pfad der gedownloadeten Datei. Erforderlich.

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

• password
  String. Kennwort, das authentifiziert werden soll. Der Standardwert ist eine leere Zeichenfolge ("").

• showUI
  Boolean. Gibt an, ob der Status des Vorgangs angezeigt werden soll. Der Standardwert ist False.

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

• overwrite
  Boolean. Gibt an, ob vorhandene Dateien überschrieben werden sollen. Der Standardwert ist False.

• onUserCancel
  UICancelOption. Gibt das Verhalten an, das auftritt, wenn ShowUI auf True festgelegt ist und der Benutzer im Dialogfeld auf Abbrechen oder Nein klickt. Der Standardwert ist ThrowException.

• networkCredentials
  ICredentials. Die anzugebenden Anmeldeinformationen.

Ausnahmen

Die folgenden Bedingungen verursachen möglicherweise das Auslösen einer Ausnahme:

• Das Laufwerk ist nicht gültig (ArgumentException).

• destinationFileName endet mit einem nachgestellten Schrägstrich (ArgumentException).

• overwrite ist auf False festgelegt, und die Zieldatei ist bereits vorhanden (IOException).

• Der Server antwortet nicht innerhalb des angegebenen connectionTimeout (TimeoutException).

• Die Authentifizierung schlägt fehl (SecurityException).

• Der Benutzer verfügt nicht über die erforderlichen Berechtigungen (SecurityException).

• Die Anforderung wird von der Website verweigert (WebException).

Hinweise

Wenn showUI auf True festgelegt ist, wird ein Dialogfeld mit dem Status des Vorgangs angezeigt. Das Dialogfeld enthält die Schaltfläche Abbrechen, mit der der Vorgang abgebrochen werden kann. Das Dialogfeld ist kein modales Dialogfeld und blockiert daher keine Benutzereingaben in anderen Fenstern des Programms.

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

DownloadFile gibt Ablaufverfolgungsinformationen aus, wenn Sie Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Enabling Network Tracing.

Hinweis:
Die DownloadFile-Methode sendet keine optionalen HTTP-Header. Einige Server geben möglicherweise den Fehler 500 (Interner Serverfehler) zurück, wenn der optionale Header des Benutzeragents fehlt. Zum Senden optionaler Header müssen Sie mithilfe der WebClient-Klasse eine Anforderung erstellen. Weitere Informationen finden Sie unter Netzwerkoperationen in .NET Framework mit Visual Basic.

Sicherheitshinweis:
Mit dem Protokoll FTP werden Informationen, einschließlich Kennwörter, als Klartext gesendet. Es sollte daher nicht für die Übertragung vertraulicher Informationen verwendet werden.

Aufgaben

Die folgende Tabelle enthält ein Beispiel für eine Aufgabe mit der My.Computer.Network.DownloadFile-Methode.

Zweck	Weitere Informationen finden Sie unter
Downloaden einer Datei	Gewusst wie: Downloaden einer Datei in Visual Basic

Beispiel

In diesem Beispiel wird die Datei WineList.txt von http://www.cohowinery.com/downloads gedownloadet und unter C:\Documents and Settings\All Users\Documents gespeichert.

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 von http://www.cohowinery.com/downloads gedownloadet und unter C:\Documents and Settings\All Users\Documents gespeichert, 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)

Anforderungen

Namespace:Microsoft.VisualBasic.Devices

Klasse:Network

Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
Windows-Anwendung	Ja
Klassenbibliothek	Ja
Konsolenanwendung	Ja
Windows-Steuerelementbibliothek	Ja
Web-Steuerelementbibliothek	Ja
Windows-Dienst	Ja
Website	Ja

Berechtigungen

Die folgenden Berechtigungen sind möglicherweise erforderlich:

Berechtigung	Beschreibung
FileIOPermission	Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted.
UIPermission	Steuert die Berechtigungen für Benutzeroberflächen und die Zwischenablage. Zugeordnete Enumeration: AllWindows.
WebPermission	Steuert die Rechte für den Zugriff auf HTTP-Internetressourcen. Zugeordnete Enumeration: Unrestricted.

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Aufgaben

Gewusst wie: Downloaden einer Datei in Visual Basic

Gewusst wie: Ermitteln, ob ein Remotecomputer verfügbar ist in Visual Basic

Gewusst wie: Analysieren von Dateipfaden in Visual Basic

Referenz

My.Computer.Network-Objekt

System.Uri

System.Net.ICredentials

Network.DownloadFile