ModuleConfiguration 表

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

ModuleConfiguration 表包含以下列。

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

路径名

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

形式

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

格式
Text 0
1
整数 2
域格式 3

类别

此列指定要更改的数据的类型。 此类型用于为任何用户界面提供上下文,而不用于合并进程。 此列的有效值取决于 "格式" 列中的值。

ContextData

此列为所请求的数据指定语义上下文。 类型用于为任何用户界面提供上下文,而不用于合并进程。 此列的有效值取决于 "格式" 和 "类型" 列中的值。

如果合并工具拒绝提供值,此列将为此记录中的项指定默认值。 此值必须具有项的格式、类型和上下文。 如果这是一个 "密钥" 格式项,则外键必须是该模块的表中的有效键。 对于此列,Null 可能是有效的值,具体取决于项。 对于 "Key" 格式项,此值为 CMSM 特殊格式。 对于所有其他类型,值将按原义处理。

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

属性

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

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

DisplayName

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

2008

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

Addendpoint

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

HelpKeyword

此列在 Addendpoint 列中提供帮助文件或命名空间中的关键字。 此关键字的解释取决于 Addendpoint 列。 此列可以为 null。

备注

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

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

验证

ICE03
ICE06
ICE25
ICE45