Método MoveFolderMoveFolder method

Move uma ou mais pastas de um local para outro.Moves one or more folders from one location to another.

SintaxeSyntax

objeto. MoveFolder (origem, destino)object.MoveFolder (source, destination)


A sintaxe do método MoveFolder tem estas partes:The MoveFolder method syntax has these parts:

PartePart DescriçãoDescription
objetoobject Obrigatório.Required. Sempre é o nome de um FileSystemObject.Always the name of a FileSystemObject.
fontesource Obrigatório.Required. O caminho para a pasta ou pastas a serem movidos.The path to the folder or folders to be moved. Cadeia de caracteres de argumento fonte pode conter caracteres curinga no último componente caminho.The source argument string can contain wildcard characters in the last path component only.
destinodestination Obrigatório.Required. O caminho onde o (s) pasta (s deverão ser movidos.The path where the folder or folders are to be moved. O argumento de destino não pode conter caracteres curinga.The destination argument can't contain wildcard characters.

ComentáriosRemarks

Se a fonte contém curingas ou destino termina com um separador de caminho (**), presume-se que destino Especifica uma pasta existente na qual mover os arquivos correspondentes.If source contains wildcards or destination ends with a path separator (**), it is assumed that destination specifies an existing folder in which to move the matching files. Caso contrário, o destino é assumido para ser o nome de uma pasta de destino para criar.Otherwise, destination is assumed to be the name of a destination folder to create. Em ambos os casos, as três coisas podem acontecer quando uma pasta individual é movida:In either case, three things can happen when an individual folder is moved:

  • Se o destino não existir, a pasta obtém movida.If destination does not exist, the folder gets moved. Esse é o caso usual.This is the usual case.

  • Se o destino for um arquivo existente, ocorrerá um erro.If destination is an existing file, an error occurs.

  • Se o destino for um diretório, ocorrerá um erro.If destination is a directory, an error occurs.

Um erro também ocorre se todas as pastas não corresponder a um caractere curinga que é usado na fonte .An error also occurs if a wildcard character that is used in source doesn't match any folders. O método MoveFolder para no primeiro erro encontra.The MoveFolder method stops on the first error it encounters. Nenhuma tentativa é feita para reverter quaisquer alterações feitas antes da ocorrência de erro.No attempt is made to roll back any changes made before the error occurs.

Importante

Esse método permite a movimentação de pastas entre volumes somente se o sistema operacional com suporte.This method allows moving folders between volumes only if supported by the operating system.

Confira tambémSee also