Akcja MoveFiles
Akcja MoveFiles lokalizuje istniejące pliki na komputerze użytkownika i przenosi lub kopiuje te pliki do nowej lokalizacji. Akcja MoveFiles wysyła zapytanie do tabeli MoveFile i przenosi pliki określone tam, jeśli składnik połączony z wpisami jest określony do zainstalowania lokalnie lub jest uruchamiany ze źródła.
Ograniczenia sekwencji
Akcja MoveFiles musi pochodzić po akcji InstallValidate i przed akcją InstallFiles.
Komunikaty ActionData
Pole | Opis danych akcji |
---|---|
[1] | Identyfikator przeniesionego pliku. |
[6] | Rozmiar zainstalowanego pliku w bajtach. |
[9] | Identyfikator katalogu zawierającego przeniesiony plik. |
Uwagi
Tabela MoveFiles zawiera kolumnę o nazwie "options", która określa pliki źródłowe do przeniesienia lub skopiowania. Przeniesiony plik źródłowy zostanie usunięty po skopiowaniu go do nowej lokalizacji. Aby uzyskać dokładną składnię, zobacz tabelę MoveFile.
Kolumny SourceFolder i DestFolder tabeli MoveFile to nazwy właściwości, których wartości mają zostać rozpoznane w pełni kwalifikowane ścieżki. Te właściwości mogą być dowolnymi wpisami katalogu w tabeli katalogu, dowolną wstępnie zdefiniowaną właściwością folderu (Folder ulubione, na przykład) lub właściwością ustawioną przez dowolny wpis w tabeli AppSearch. Te właściwości mogą zawierać pełną ścieżkę zawierającą nazwę pliku do określonego pliku. Na przykład można utworzyć tabelę AppSearch, aby wyszukać określony plik i ustawić właściwość na pełną ścieżkę do tego pliku. W tym przykładzie kolumna SourceName w tabeli MoveFile może być pusta, aby wskazać, że wartość we właściwości SourceFolder zawiera pełną ścieżkę pliku. Średnik jest ogranicznikiem listy dla przekształceń, źródeł i poprawek i nie należy ich używać w nazwach plików lub ścieżkach.
Akcja MoveFiles nie działa na wpisy w tabeli MoveFile, w której właściwość SourceFolder lub DestFolder nie ocenia pełnej ścieżki.
Akcja MoveFiles próbuje przenieść lub skopiować wszystkie pliki w katalogu źródłowym, które są zgodne z nazwą podaną w kolumnie SourceName tabeli MoveFiles. Nazwa w kolumnie SourceName może zawierać wartość * lub ? symbole wieloznaczne, które umożliwiają przenoszenie lub kopiowanie grup plików. Na przykład kolumna SourceName może zawierać wpis "*.xls" i akcja MoveFiles przenosi lub kopiuje każdy skoroszyt programu Microsoft Excel z katalogu źródłowego do miejsca docelowego.
Nazwę, która ma zostać nadana plikowi docelowemu, można określić w kolumnie DestName tabeli MoveFile. Nazwa pliku docelowego zachowuje nazwę pliku źródłowego, jeśli ta kolumna pozostanie pusta.
Jeśli symbol wieloznaczny "*" zostanie wprowadzony w kolumnie SourceName tabeli MoveFile, a nazwa pliku docelowego jest określona w kolumnie DestName, wszystkie przeniesione lub skopiowane pliki zachowują nazwy w źródłach.
Pliki, które są przenoszone lub kopiowane przez akcję MoveFiles, nie są usuwane po odinstalowaniu produktu.