InstallFiles 操作
InstallFiles 操作将 File 表中指定的文件从源目录复制到目标目录。
序列限制
InstallFiles 操作必须在 InstallValidate 操作之后以及任何文件相关的操作之前执行。
ActionData 消息
| 字段 | 操作数据说明 |
|---|---|
| [1] | 已安装文件的标识符。 |
| [6] | 已安装文件的大小（以字节为单位）。 |
| [9] | 包含已安装文件的目录的标识符。 |
备注
InstallFiles 操作对 File 表中指定的文件进行操作。 每个文件都根据 Component 表中文件的关联组件的安装状态进行安装。 只有其组件解析为 msiInstallStatelocal 状态的文件才有资格进行复制。
InstallFiles 操作实现 File 表的以下列。
- FileName 列指定目标文件名。
- Version 列指定文件版本。
- Attributes 列指定文件和安装属性标志位。
- File 列指定唯一的文件标记。
- FileSize 列指定未压缩的文件大小（以字节为单位）。
- Language 列指定文件语言标识符。
- Sequence 列指定媒体上的序列号。
InstallFiles 操作实现 Component 表的以下列。
- Directory_ 列指定对 Directory 表项的引用。
- Component 列指定组件项的唯一名称。
仅当满足以下条件之一时，才会复制指定的文件：
- 文件当前未安装在本地计算机上。
- 该文件位于本地计算机上，但版本号低于 File 表中的文件。
- 文件位于本地计算机上，但没有关联的版本号。
要复制的每个文件的源目录由 sourceMode 确定，而 sourceMode 又取决于 Media 表的 Cabinet 列中的值。 有关源模式的完整讨论，请参阅 Media 表。
如果要复制的文件的源目录驻留在软盘或 CD-ROM 等可移动媒体上，则 InstallFiles 操作会在尝试复制文件之前验证是否已插入正确的源媒体。 InstallFiles 搜索具有与 Media 表的 VolumeLabel 列中给定的值匹配的卷标签的同一可移动类型的媒体。 如果找到匹配的已装载卷，则文件复制过程继续进行。 如果未找到匹配项，则会显示一个对话框，要求用户插入正确的媒体。 在这种情况下，对话框使用在 Media 表的 DiskPrompt 列中找到的媒体名称作为提示的一部分。
必须小心，因为 InstallFiles 操作可以删除原始文件，而不是替换它。 当 InstallFiles 操作在替换旧文件时遇到错误，并且用户选择忽略该错误时，会发生此情况。 安装程序的默认行为是先删除旧文件，然后再确保正确复制新文件。
有关安装程序使用的文件版本控制规则，请参阅文件版本控制规则。