My.Computer.Network.DownloadFile-Methode

DownloadFile-Methode (My.Computer.N...

Alle reduzieren

Sprachfilter

Diese Seite ist spezifisch für

Microsoft Visual Studio 2008/.NET Framework 3.5

Andere Versionen stehen ebenfalls zur Verfügung für:

Microsoft Visual Studio 2005/.NET Framework 2.0

Visual Basic-Sprachreferenz

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.

Visual Basic

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.

Visual Basic

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