ModuleConfiguration 表

ModuleConfiguration 表标识模块的可配置属性。此表未合并到数据库中。

ModuleConfiguration 表具有以下列。

列

名称

此字段定义可配置项的名称。此名称在 ModuleSubstitution 表的 Value 列中的格式模板中引用。

格式

此列指定正在更改的数据的格式。

类型

此列指定要更改的数据的类型。此类型用于提供任何用户界面的上下文，并且未在合并过程中使用。此列的有效值取决于 Format 列中的值。

ContextData

此列指定所请求数据的语义上下文。该类型用于提供任何用户界面的上下文，并且不会在合并过程中使用。此列的有效值取决于“格式”和“类型”列中的值。

DefaultValue

如果合并工具拒绝提供值，则此列指定此记录中项的默认值。此值必须具有项的格式、类型和上下文。如果这是“键”格式项，则外键必须是模块表中的有效键。 Null 可能是此列的有效值，具体取决于项。对于“键”格式项，此值采用 CMSM 特殊格式。对于所有其他类型，该值将按字面处理。

模块作者必须确保模块在其默认状态下有效。这可确保低于版本 2.0 的 Mergemod.dll 版本仍可使用其默认状态的模块。

属性

此列是包含此可配置项的属性的位字段。 Null 等效于 0。此列中的所有其他位都保留供将来使用，并且必须为 0。

名字	十进制	十六进制	描述
msmConfigurableOptionKeyNoOrphan	1	0x00000001	此属性仅适用于在其 DefaultValue 字段中列出模块表外键的记录。合并工具忽略除键格式类型以外的任何格式的属性。 ModuleSubstitution 表中未列出的项将从以下检查中排除。如果完成所有配置选项后满足以下条件，合并工具不会将 DefaultValue 列引用的行合并到目标数据库中。 ModuleConfiguration 表中具有相同 DefaultValue 的每一行都有 msmConfigurationItemsKeyNoOrphan 集。没有行使用 DefaultValue，因为创作工具拒绝提供值。如果满足以下任一条件，合并工具将合并该行。合并工具查找未设置 msmConfigItemsKeyNoOrphan 的任何行。如果合并工具使用 DefaultValue 找到任何行，因为创作工具拒绝提供值。
msmConfigurableOptionNonNullable	2	0x00000002	设置此属性时，null 不是此项的有效响应。此属性对整数格式类型或位域格式类型无效。

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 表。