My.Computer.Network.UploadFile, méthode

Mise à jour : novembre 2007

Envoie le fichier spécifié à l'adresse de l'hôte indiquée.

' 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 _
)

Paramètres

• sourceFileName
  String. Chemin d'accès et nom du fichier à transférer. Obligatoire.

• address
  String ou Uri URL, adresse IP ou URI du serveur de destination. Obligatoire.

• userName
  String. Nom d'utilisateur pour authentification. La valeur par défaut est une chaîne vide : "".

• password
  String. Mot de passe pour authentification. La valeur par défaut est une chaîne vide : "".

• showUI
  Boolean. Si besoin d'afficher l'avancement de l'opération. La valeur par défaut est False.

• connectionTimeout
  Int32. Intervalle de délai en millisecondes. La valeur par défaut est de 100 secondes.

• onUserCancel
  UICancelOption. Mesures à prendre lorsque l'utilisateur clique sur Annuler. La valeur par défaut est ThrowException.

• networkCredentials
  ICredentials. Informations d'identification pour l'authentification.

Exceptions

Les conditions ci-dessous peuvent générer une exception :

• Le chemin d'accès local n'est pas valide (ArgumentException).

• connectionTimeout est inférieur ou égal à zéro (ArgumentException).

• address ne comporte pas de nom de fichier (InvalidOperationException).

• L'authentification a échoué (SecurityException).

• L'utilisateur n'a pas les autorisations nécessaires (SecurityException).

• Le délai de connexion a expiré (TimeoutException).

• Le site Web refuse la demande (WebException).

Notes

Si showUI a la valeur True, une boîte de dialogue affiche l'avancement de l'opération ; elle comporte un bouton Annuler sur lequel l'utilisateur peut cliquer afin d'annuler l'opération. Cette boîte de dialogue n'étant pas modale, elle ne bloque pas les entrées d'utilisateur dans les autres fenêtres du programme.

Si le serveur ne répond pas au cours de l'intervalle spécifié dans connectionTimeout, l'opération est annulée et une exception est levée.

My.Computer.Network.UploadFile génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d'informations, consultez Enabling Network Tracing.

Note de sécurité :
Le protocole FTP envoie les informations, y compris les mots de passe, en texte brut, et ne doit pas être utilisé pour transmettre des informations sensibles.

Tâches

Le tableau suivant présente un exemple de tâche impliquant la méthode My.Computer.Network.UploadFile.

Exemple

Cet exemple transfère le fichier Order.txt dans http://www.cohowinery.com/uploads.

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

Cet exemple transfère le fichier Order.txt dans http://www.cohowinery.com/uploads sans fournir de nom d'utilisateur ou de mot de passe, affiche la progression du transfert et présente un intervalle de délai d'attente de 500 millisecondes.

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

Configuration requise

Espace de noms :Microsoft.VisualBasic.Devices

Classe :Network

Assembly : bibliothèque runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Autorisations

Les autorisations suivantes peuvent être nécessaires :

Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.

Voir aussi

Tâches

Comment : télécharger un fichier dans Visual Basic

Comment : analyser des chemins d'accès dans Visual Basic

Référence

My.Computer.Network, objet

System.Uri

System.Net.ICredentials

Microsoft.VisualBasic.FileIO.UICancelOption

Network.UploadFile