MoveFile, méthode

Microsoft VBScript

Microsoft® Visual Basic® Scripting Edition MoveFile, méthode  Référence de la bibliothèque d'exécution Scripting
Version 3

Voir aussi                  Application


Description
Change l'emplacement d'un ou plusieurs fichiers.
Syntaxe
object.MoveFile source, destination

La syntaxe de la méthode MoveFile comprend les éléments suivants :

Élément Description
object Correspond toujours au nom d'un objet FileSystemObject.
source Chemin du ou des fichiers à déplacer. La chaîne argument source peut contenir des caractères génériques dans le dernier composant du chemin uniquement.
destination Chemin de destination du ou des fichiers à déplacer. L'argument destination ne peut pas contenir de caractères génériques.

Notes
Si l'argument source contient des caractères génériques ou si destination se termine par un séparateur de chemin (\), destination est considéré comme un dossier existant vers lequel s'effectue le déplacement des dossiers et sous-dossiers désignés. Sinon, destination est considéré comme le nom d'un fichier de destination à créer. Dans les deux cas, le déplacement d'un fichier individuel présente trois possibilités :
  • Si destination n'existe pas, le fichier est déplacé. C'est le cas le plus courant.
  • Si destination est un fichier existant, une erreur se produit.
  • Si destination est un dossier, une erreur se produit.
Une erreur se produit aussi si une source contenant des caractères génériques ne correspond à aucun fichier. La méthode MoveFile s'arrête sur la première erreur rencontrée. Aucune tentative n'est effectuée pour annuler les modifications précédant l'erreur.

L'exemple ci-dessous illustre l'utilisation de la méthode MoveFile :

Sub MoveAFile(Drivespec)
  Dim fso
  Set fso = CreateObject("Scripting.FileSystemObject")
  fso.MoveFile Drivespec, "c:\windows\bureau\"
End Sub

Important  Cette méthode permet le déplacement de fichiers entre des volumes distincts uniquement si le système d'exploitation gère cette opération.