My.Computer.Network.UploadFile-Methode

Aktualisiert: November 2007

Sendet die angegebene Datei an die angegebene Hostadresse.

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

Parameter

• sourceFileName
  String. Pfad und Name der Datei, die geuploadet werden soll. Erforderlich.

• address
  String oder Uri. URL, IP-Adresse oder URI des Zielservers. Erforderlich.

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

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

• showUI
  Boolean. Ob der Fortschritt des Vorgangs angezeigt werden soll. Der Standardwert ist False.

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

• onUserCancel
  UICancelOption. Aktion, die ausgeführt werden soll, wenn der Benutzer auf Abbrechen klickt. Der Standardwert ist ThrowException.

• networkCredentials
  ICredentials. Anmeldeinformationen für die Authentifizierung.

Ausnahmen

Die folgenden Bedingungen können eine Ausnahme verursachen:

• Der Pfad der lokalen Datei ist nicht gültig (ArgumentException).

• connectionTimeout ist kleiner oder gleich 0 (null) (ArgumentException).

• address enthält keinen Dateinamen (InvalidOperationException).

• Die Authentifizierung ist fehlgeschlagen (SecurityException).

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

• Timeout der Verbindung (TimeoutException).

• Die Website verweigert die Anforderung (WebException).

Hinweise

Wenn showUI auf True festgelegt wurde, wird ein Dialogfeld mit dem Status des Vorgangs angezeigt, das die Schaltfläche Abbrechen aufweist, auf die der Benutzer klicken kann, um den Vorgang abzubrechen. Weil das Dialogfeld kein modales Dialogfeld ist, blockiert es keine Benutzereingaben in anderen Fenstern des Programms.

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

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

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.UploadFile-Methode.

Beispiel

In diesem Beispiel wird die Datei Order.txt auf http://www.cohowinery.com/uploads geuploadet.

My.Computer.Network.UploadFile ( "C:\My Documents\Order.txt", _
"http://www.cohowinery.com/upload.aspx")

In diesem Beispiel wird die Datei Order.txt auf http://www.cohowinery.com/uploads geuploadet, ohne einen Benutzernamen oder ein Kennwort anzugeben. Der Status des Uploads wird angezeigt, und das Timeoutintervall beträgt 500 Millisekunden.

My.Computer.Network.UploadFile ("C:\My Documents\Order.txt", _
"http://www.cohowinery.com/upload.aspx","","",True,500)

Anforderungen

Namespace:Microsoft.VisualBasic.Devices

Klasse:Network

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

Verfügbarkeit nach Projekttyp

Berechtigungen

Die folgenden Berechtigungen sind möglicherweise erforderlich:

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

Siehe auch

Aufgaben

Gewusst wie: Downloaden einer Datei in Visual Basic

Gewusst wie: Analysieren von Dateipfaden in Visual Basic

Referenz

My.Computer.Network-Objekt

System.Uri

System.Net.ICredentials

Microsoft.VisualBasic.FileIO.UICancelOption

Network.UploadFile