ModuleConfiguration 資料表

ModuleConfiguration 資料表會識別模組的可設定屬性。此資料表不會合並至資料庫。

ModuleConfiguration 資料表具有下列資料行。

資料行	類型	答案	Nullable
名稱	識別碼	Y	N
格式	整數	N	N
類型	Text	N	Y
CoNtextData	Text	N	Y
DefaultValue	Text	N	Y
屬性	整數	N	Y
DisplayName	Text	N	Y
Description	Text	N	Y
HelpLocation	Text	N	Y
HelpKeyword	Text	N	Y

資料行

名字

此欄位會定義可設定專案的名稱。此名稱會在 ModuleSubstitution 資料表的 Value 資料行格式設定範本中參考。

格式

此資料行會指定所變更資料的格式。

類型

此資料行會指定所變更資料的型別。此類型可用來提供任何使用者介面的內容，而且不會在合併程式中使用。此資料行的有效值取決於 Format 資料行中的值。

CoNtextData

此資料行會指定所要求資料的語意內容。此類型用來提供任何使用者介面的內容，而且不會在合併程式中使用。此資料行的有效值取決於 Format 和 Type 資料行中的值。

DefaultValue

如果合併工具拒絕提供值，此資料行會指定此記錄中專案的預設值。此值必須具有專案的格式、類型和內容。如果這是「索引鍵」格式專案，外鍵必須是模組資料表的有效索引鍵。 Null 可能是此資料行的有效值，視專案而定。對於「索引鍵」格式專案，此值為 CMSM 特殊格式。針對所有其他類型，此值會以常值方式處理。

模組作者必須確保模組在其預設狀態中有效。這可確保版本 2.0 之前的 Mergemod.dll仍可使用模組的預設狀態。

屬性

此資料行是位欄位，其中包含這個可設定專案的屬性。 Null 相當於 0。此資料行中的所有其他位都會保留供日後使用，且必須為 0。

名稱	Decimal	十六進位	Description
msmConfigurableOptionKeyNoOrphan	1	0x00000001	此屬性僅適用于將外鍵列出至其 DefaultValue 欄位中模組資料表的記錄。合併工具會忽略索引鍵格式類型以外的任何格式的屬性。 ModuleSubstitution 資料表中未列出的專案會從下列檢查中排除。如果完成所有組態選項之後符合下列條件，合併工具就不會將 DefaultValue 資料行所參考的資料列合併到目標資料庫。 ModuleConfiguration 資料表中具有相同 DefaultValue 的每個資料列都有 msmConfigurationItemsKeyNoOrphan 集合。沒有資料列使用 DefaultValue，因為撰寫工具拒絕提供值。如果符合下列任一條件，合併工具就會合並資料列。合併工具會尋找未設定 msmConfigItemsKeyNoOrphan 的任何資料列。如果合併工具使用 DefaultValue 尋找任何資料列，因為撰寫工具拒絕提供值。
msmConfigurableOptionNonNullable	2	0x00000002	設定此屬性時，null 不是這個專案的有效回應。此屬性對整數格式類型或 Bitfield 格式類型沒有作用。

DisplayName

此資料行提供此專案的簡短描述，可供撰寫工具在使用者介面中使用。此資料行可能未當地語系化。將此資料行設定為 null，讓模組要求撰寫工具不會在 UI 中公開此屬性。此工具可能會忽略此欄位中的值。

描述

此資料行提供此專案的描述，此專案可供撰寫工具在 UI 元素中使用。此字串可由模組的語言轉換進行當地語系化。此資料行可能是 Null。

HelpLocation

此資料行提供說明檔的名稱， (不含 .chm 副檔名) 或以分號分隔的說明命名空間清單。如果沒有可用的說明，這個資料行可以是 Null。只有當 HelpKeyword 資料行為 Null 時，此資料行才能為 Null。

HelpKeyword

此資料行會從 HelpLocation 資料行提供說明檔或命名空間的關鍵字。此關鍵字的解譯取決於 HelpLocation 資料行。此資料行可能是 Null。

ModuleConfiguration 資料表是由可設定的合併模組使用。需要Mergemod.dll 2.0 或更新版本，才能建立可設定的合併模組。

為了確保與舊版Mergemod.dll相容，應該將 ModuleConfiguration 資料表和 ModuleSubstitution 資料表新增至每個模組的 ModuleIgnoreTable 資料表。