合并到当前作用域指定一个或多个以前调用的所有元数据作用域imetadataemit:: Merge。
语法
HRESULT MergeEnd ();
参数
此方法需要任何参数。
备注
此例程将触发实际合并的元数据,所有的导入以前调用指定作用域IMetaDataEmit::Merge,到当前的输出范围。
以下特殊条件适用于合并:
-
永远不会导入的模块版本标识符 (mvid) 发生,因为它是唯一的导入作用域中的元数据。
-
将不覆盖任何现有模块范围内的属性。
如果已为当前作用域设置模块属性,导不入任何模块属性。 但是,如果尚未在当前作用域中设置模块属性,它们是导入后仅当其首先出现。 如果再次遇到这些模块属性,它们是重复项。 如果 (除了 mvid) 发生的所有模块属性的值进行比较并且找到了没有重复项,将引发错误。
-
有关类型定义 (
TypeDef),没有重复项将合并到当前作用域。TypeDef检查对象是否已对每个重复项完全限定对象名称 + GUID + 版本号。 如果没有匹配名称或 GUID,并且任何其他两个元素则不同,将引发错误。 否则为如果所有三个项匹配,MergeEnd执行粗略检查以确保这些项确实重复项; 如果没有,将引发错误。 此粗略的检查是查找:-
相同的成员声明中的相同顺序出现。 标记为成员
mdPrivateScope(请参阅CorMethodAttr枚举) 不包含在此检查; 特别合并。 -
相同的类布局。
这意味着,
TypeDef对象必须始终完全且一致地定义每个元数据范围内声明它; 如果其成员的实现 (类) 分布在多个编译单元中,假定的完整定义为存在于每个范围内,不是增量对每个作用域。 例如,如果参数名称与协定相关,它们必须发出相同的方式引入每个作用域;如果它们不相关,它们不应将发送到元数据。例外情况是,
TypeDef对象可以具有标记为增量成员mdPrivateScope。 在遇到这些,MergeEnd以增量方式将其添加到当前作用域而不考虑重复项。 由于编译器能够识别专用作用域,编译器必须负责强制执行规则。 -
-
不导入或合并; 相对虚拟地址 (Rva)编译器会重新发出此信息。
-
仅当合并附加到的项时,将合并自定义属性。 例如,当第一次遇到此类合并与类关联的自定义属性。 如果与之关联的自定义特性
TypeDef或MemberDef这就是特定于编译单元 (例如成员编译的时间戳),它们将不会合并,并将由编译器删除或更新此类元数据。
要求
平台: 请参阅系统需求。
标头: Cor.h
库: 用作 MSCorEE.dll 中的资源
.NET Framework 版本: 自 1.1 之后可用
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 mairaw)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
