Ação MoveFiles

A ação MoveFiles 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 arquivos especificados lá se o componente vinculado às entradas for especificado para ser instalado localmente ou estiver sendo executado na 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

Campo	Descrição dos dados de ação
[1]	Identificador do arquivo movido.
[6]	Tamanho do arquivo instalado em bytes.
[9]	Identificador do diretório que mantém o arquivo movido.

 

Observações

A tabela MoveFiles contém uma coluna chamada "opções" que especifica os arquivos de origem a serem movidos ou copiados. Um arquivo de origem movido é excluído depois que ele é copiado para um novo local. 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 que contém 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 como o caminho completo para esse arquivo. Neste exemplo, a coluna SourceName na tabela MoveFile pode ficar 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 na qual a propriedade SourceFolder ou DestFolder não é avaliada como um caminho completo.

A ação MoveFiles tenta mover ou copiar todos os arquivos no diretório de origem que correspondem ao nome fornecido na coluna SourceName da tabela MoveFiles. O nome na coluna SourceName pode incluir o * 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 todas as pastas 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 reterá o nome do arquivo de origem se esta 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 reterão os nomes nas fontes.

Os arquivos movidos ou copiados pela ação MoveFiles não são excluídos quando o produto é desinstalado.