ModuleConfiguration 表

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

ModuleConfiguration 表包含以下列。

类型 密钥 Nullable
名称 标识符 Y N
格式 整数 N N
类型 文本 N Y
ContextData Text N Y
DefaultValue Text N Y
属性 整数 N Y
DisplayName Text N Y
说明 文本 N Y
HelpLocation Text N Y
HelpKeyword Text N Y

 

名字

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

格式

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

格式
Text 0
Key 1
整数 2
Bitfield 格式 3

 

类型

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

ContextData

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

DefaultValue

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

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

属性

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

名称 小数 十六进制 说明
msmConfigurableOptionKeyNoOrphan 1 0x00000001 此属性仅适用于在其 DefaultValue 字段中列出模块表外键的记录。 合并工具忽略 键格式类型以外的任何格式的属性。 ModuleSubstitution 表中未列出的项将从以下检查中排除。 如果完成所有配置选项后满足以下条件,合并工具不会将 DefaultValue 列引用的行合并到目标数据库中。
具有同一 DefaultValue 的 ModuleConfiguration 表中的每一行都有 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 表中

验证

ICE03
ICE06
ICE25
ICE45