ModuleConfiguration 表

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

ModuleConfiguration 表包含以下列。

列	类型	密钥	Nullable
名称	Identifier	Y	N
格式	整数	N	N
类型	文本	N	Y
ContextData	文本	N	Y
DefaultValue	文本	N	Y
特性	整数	N	Y
DisplayName	文本	N	Y
说明	文本	N	Y
HelpLocation	文本	N	Y
HelpKeyword	文本	N	Y

列

Name

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

Format

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

Type

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

ContextData

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

DefaultValue

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

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

Attributes

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

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

DisplayName

此列提供创作工具可在用户界面中使用的此项的简短说明。此列可能未本地化。将此列设置为 null，让模块请求创作工具不在 UI 中公开此属性。该工具可能会忽略此字段中的值。

Description

此列提供创作工具可在 UI 元素中使用的此项的说明。此字符串可以通过模块的语言转换进行本地化。此列可能为 null。

HelpLocation

此列提供帮助文件的名称（没有 .chm 扩展名）或以分号分隔的帮助命名空间列表。如果没有可用的帮助，则此列可以为 null。仅当 HelpKeyword 列为 null 时，此列才能为 null。

HelpKeyword

此列从 HelpLocation 列向帮助文件或命名空间提供关键字。此关键字的解释取决于 HelpLocation 列。此列可能为 null。

ModuleConfiguration 表由可配置的合并模块使用。创建可配置的合并模块需要 Mergemod.dll 2.0 或更高版本。

为确保与较旧版本的 Mergemod.dll 兼容，ModuleConfiguration 表和 ModuleSubstitution 表应添加到每个模块的 ModuleIgnoreTable 表中。