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.
Pour |
Consultez |
---|---|
Transférer un fichier |
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
Type de projet |
Disponible |
---|---|
Application Windows |
Oui |
Bibliothèque de classes |
Oui |
Application console |
Oui |
Bibliothèque de contrôles Windows |
Oui |
Bibliothèque de contrôles Web |
Oui |
Service Windows |
Oui |
Site Web |
Oui |
Autorisations
Les autorisations suivantes peuvent être nécessaires :
Autorisation |
Description |
---|---|
Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted. |
|
Contrôle les autorisations relatives aux interfaces utilisateur et au presse-papiers. Énumération associée : AllWindows. |
|
Contrôle les droits d'accès aux ressources Internet HTTP. Énumération associée : Unrestricted. |
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