FileTable
[檔案資料表] 包含來源檔案的完整清單,其各種屬性會依唯一、非當地語系化的識別碼排序。 檔案可以儲存在來源媒體上,做為個別檔案或壓縮在 封包檔案內。 如需詳細資訊,請參閱 使用封包和壓縮的來源。
[檔案資料表] 具有下列資料行。
資料行 | 類型 | 答案 | Nullable |
---|---|---|---|
檔案 | 識別碼 | Y | N |
元件_ | 識別碼 | N | N |
FileName | 檔案名稱 | N | N |
FileSize | DoubleInteger | N | N |
版本 | 版本 | N | Y |
語言 | 語言 | N | Y |
屬性 | 整數 | N | Y |
順序 | 整數 | N | N |
-
檔
-
可唯一識別檔案的非當地語系化權杖。 此欄位不區分大小寫。 請勿將識別碼指派給只有大小寫不同的檔案。
-
元件_
-
元件 資料表第一個資料行的外部索引鍵。 此欄位會識別控制檔案的元件。
-
檔案名
-
用於安裝的檔案名。 名稱可以當地語系化。
由於某些網頁伺服器可能會區分大小寫,因此 FileName 應該完全符合來源檔案的大小寫,以確保支援網際網路下載。
-
FileSize
-
以位元組為單位的檔案大小。 這必須是非負數。
-
版本
-
此欄位是版本檔案的版本字串。 非版本化檔案的這個欄位是空白的。 在此欄位中輸入的檔案版本必須與安裝套件隨附的檔案版本相同。
[版本] 欄位也可以設定為包含 [檔案] 資料表中另一筆記錄的主鍵。 參考的檔案接著會決定此檔案的版本設定邏輯。 如需詳細資訊,請參閱 隨附檔案。 請注意,如果此檔案是其元件的索引鍵路徑,則不得指定為隨附檔案。
-
語言
-
以逗號分隔的十進位語言識別項清單。
字型檔案不應以語言識別項撰寫,因為字型沒有內嵌的語言識別項資源。 因此,此資料行應該為字型檔案保留 null。
-
屬性
-
整數,包含表示檔案屬性的位旗標。
下表顯示位欄位的定義。
常數 十六進位 Decimal 描述 msidbFileAttributesReadOnly 0x000001 1 唯讀 msidbFileAttributesHidden 0x000002 2 Hidden msidbFileAttributesSystem 0x000004 4 系統 msidbFileAttributesVital 0x000200 512 檔案對於它所屬元件的精確作業而言非常重要。 如果具有 msidbFileAttributesVital 屬性的檔案安裝失敗,則安裝會停止並回復。 在此情況下,安裝程式會顯示沒有 [忽略] 按鈕的對話方塊。 如果未設定此屬性,且檔案安裝失敗,安裝程式會顯示對話方塊,其中包含 [忽略] 按鈕。 在此情況下,使用者可以選擇忽略安裝檔案失敗並繼續。 msidbFileAttributesChecksum 0x000400 1024 檔案包含有效的 總和檢查碼。 修復已損毀的檔案需要總和檢查碼。 msidbFileAttributesPatchAdded 0x001000 4096 此位只能由修補程式新增,如果修補程式正在新增檔案,則為 。 msidbFileAttributesNoncompressed 0x002000 8192 檔案的來源類型未壓縮。 如果設定,請忽略[計數摘要] 屬性Word。 如果msidbFileAttributesNoncompressed或msidbFileAttributesCompressed都未設定,檔案的壓縮狀態是由Word Count Summary屬性所指定。 請勿同時設定 msidbFileAttributesNoncompressed 和 msidbFileAttributesCompressed。 msidbFileAttributesCompressed 0x004000 16384 檔案的來源類型已壓縮。 如果設定,請忽略[計數摘要] 屬性Word。 如果msidbFileAttributesNoncompressed或msidbFileAttributesCompressed都未設定,檔案的壓縮狀態是由Word Count Summary屬性所指定。 請勿同時設定 msidbFileAttributesNoncompressed 和 msidbFileAttributesCompressed。 如果已設定 Attributes 資料行內的 msidbFileAttributesVital 位,而且如果已選取檔案所屬的元件進行安裝,則安裝程式必須能夠安裝此檔案,才能順利完成安裝。 例如,如果安裝程式因為某些原因而無法安裝檔案 (,如果來源檔案無法位於來源映射) ,則會出現錯誤對話方塊,其中包含 [重試] 或 [取消] 選項。 對於未設定 msidbFileAttributesVital 的檔案,安裝錯誤時的選項會是 「Abort」、「Retry」 和 「Ignore」 (,也就是說,使用者可以選擇順利完成安裝,而不需要安裝該檔案) 。
在 [屬性] 資料行內的 msidbFileAttributesChecksum 位應該針對安裝中的每個可執行檔設定,該可執行檔的有效 總和檢查碼 儲存在可攜式可執行檔 (PE) 檔頭。 只有在重新安裝期間,才會驗證已設定此位的檔案是否有有效的總和檢查碼。 如需詳細資訊,請參閱 REINSTALLMODE。
-
序列
-
此檔案在媒體影像上的順序位置。 如果壓縮磁碟案,此順序必須對應至封包中的檔案順序。 此欄位中的整數必須等於或大於 1。
[順序] 資料行中的序號可用來指定檔案的安裝順序,以及檔案所在的來源媒體 (與 媒體資料表) 。 例如,假設檔案的序號為 92。 若要判斷此檔案所在的來源磁片,請在 Media 資料表中尋找小於 92 之最後一個序列值的專案。
雖然壓縮檔案會指派封包中的內部序號,但這些絕對數位不需要符合 File 資料表內的序號。 不過,請務必將 [檔案] 資料表中的檔案序列與封包內的檔案序列相同。
對於未壓縮的檔案,序號不一定是唯一的。 例如,如果所有檔案都未壓縮,且全部都位於一個磁片上,您可以為所有檔案提供相同的序號。
上限為 32767 個檔案。 若要建立具有更多檔案的 Windows Installer 套件,請參閱 撰寫大型套件。
順序資料表中的InstallFiles和RemoveFiles動作會處理此資料表中的資訊。 如需使用 時序表的詳細資訊,請參閱 使用時序表。
資料表一開始是從檔案清單產生,但如果使用封包壓縮,則會從壓縮引擎的輸出重新產生資料表。 如需詳細資訊,請參閱 封包檔案。
若要在安裝期間移動使用者電腦上的現有檔案,請使用 MoveFiles 動作 和 MoveFile 資料表。 若要將檔案安裝到多個位置,請使用 DuplicateFiles 動作 和 DuplicateFile 資料表。
下表摘要說明 [版本] 資料行和 [語言] 資料行中值的可能組合。 如需詳細資訊,請參閱 檔案版本設定規則。
版本 | Language | 描述 |
---|---|---|
1.2.3.4 | 1033 | 版本和語言。 |
1.2.3.4 | (Null) | 版本,但沒有語言。 |
1.2.3.4 | 0 | 版本和語言為中性。 |
Testdb | (Null) | 沒有與其相關語言的隨附檔案。 |
Testdb | 1033 | 隨附檔案和語言。 |
(Null) | 1033 | 沒有版本,但有與其相關聯的語言, (也就是 typelib、helpfile) 。 |
如需詳細資訊,請參閱 MsiLockPermissionsEx Table 和 LockPermissions 資料表。
ICE02
ICE03
ICE04
ICE06
ICE18
ICE30
ICE32
ICE35
ICE39
ICE42
ICE45
ICE50
ICE51
ICE54
ICE55
ICE57
ICE59
ICE60
ICE67
ICE69
ICE76
ICE91