Ação MoveFiles
A ação MoverArquivos localiza arquivos existentes no computador do usuário e move ou copia esses arquivos para um novo local. A ação MoveFiles consulta a tabela MoveFile e move os arquivos especificados lá se o componente vinculado às entradas for especificado para ser instalado localmente ou estiver sendo executado a partir da origem.
Restrições de sequência
A ação MoveFiles deve vir após a ação InstallValidate e antes da ação InstallFiles.
Mensagens ActionData
| Domínio | Descrição dos dados da ação |
|---|---|
| [1] | Identificador do arquivo movido. |
| [6] | Tamanho do arquivo instalado em bytes. |
| [9] | Identificador do diretório que contém o arquivo movido. |
Comentários
A tabela MoveFiles contém uma coluna chamada "options" que especifica os arquivos de origem a serem movidos ou copiados. Um ficheiro de origem movido é eliminado depois de ter sido copiado para uma nova localização. Para obter a sintaxe exata, consulte a tabela MoveFile.
As colunas SourceFolder e DestFolder da tabela MoveFile são nomes de propriedade cujos valores devem ser resolvidos para caminhos totalmente qualificados. Essas propriedades podem ser qualquer uma das entradas de diretório na tabela Directory, qualquer propriedade de pasta predefinida (FavoritesFolder, por exemplo) ou uma propriedade definida por qualquer entrada na tabela AppSearch. Essas propriedades podem conter um caminho completo contendo o nome do arquivo para um arquivo específico. Por exemplo, a tabela AppSearch pode ser criada para pesquisar um arquivo específico e definir uma propriedade para o caminho completo para esse arquivo. Neste exemplo, a coluna SourceName na tabela MoveFile pode ser deixada em branco para indicar que o valor na propriedade SourceFolder contém um caminho de arquivo completo. O ponto-e-vírgula é o delimitador de lista para transformações, fontes e patches e não deve ser usado em nomes de arquivo ou caminhos.
A ação MoveFiles não atua em entradas na tabela MoveFile nas quais a propriedade SourceFolder ou DestFolder não avalia um caminho completo.
A ação MoveFiles tenta mover ou copiar todos os arquivos no diretório de origem que correspondam ao nome fornecido na coluna SourceName da tabela MoveFiles. O nome na coluna SourceName pode incluir * ou ? curingas que permitem que um grupo de arquivos seja movido ou copiado. Por exemplo, a coluna SourceName pode conter uma entrada de "*.xls" e a ação MoveFiles move ou copia cada pasta de trabalho do Microsoft Excel do diretório de origem para o destino.
O nome a ser dado ao arquivo de destino pode ser especificado na coluna DestName da tabela MoveFile. O nome do arquivo de destino retém o nome do arquivo de origem se essa coluna for deixada em branco.
Se um curinga "*" for inserido na coluna SourceName da tabela MoveFile e um nome de arquivo de destino for especificado na coluna DestName, todos os arquivos movidos ou copiados manterão os nomes nas fontes.
Os arquivos movidos ou copiados pela ação MoveFiles não são excluídos quando o produto é desinstalado.