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:

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