如何将 COM 组件添加到应用程序

本主题介绍如何使用 BizTalk Server 管理控制台或命令行向 BizTalk 应用程序添加 COM 组件:

向应用程序中添加 COM 组件时,请切记以下几点:

  • 如果要覆盖应用程序中已有的 COM 组件,请指定“Overwrite”选项。 仅当两个项目具有相同的本地唯一标识符 (LUID) 时才需要覆盖选项。 如果未指定覆盖选项,且应用程序中已经存在与要添加的组件具有相同 LUID 的 COM 组件,则添加操作将失败。 可以使用 ListApp 命令查看应用程序中项目的 LUID。

  • BizTalk Server 不检查 COM 组件的依存关系以验证它们是否存在,因此您应该验证组件依赖的任何项目是否存在。

  • 如果添加 64 位的非托管 COM 或 COM+ 组件,并尝试在 32 位的计算机上安装包含 COM 或 COM+ 组件的应用程序,则不会安装该组件。 它将仅在 64 位计算机上安装。

必备条件

若要执行本主题中的过程,必须使用属于 BizTalk Server 管理员组成员的帐户登录。 有关权限的更多详细信息,请参阅 部署和管理 BizTalk 应用程序所需的权限

向应用程序添加 COM 组件

使用 BizTalk Server 管理控制台

  1. 依次单击“开始”、“程序”、“Microsoft BizTalk Server 20xx”、“BizTalk Server管理”。

  2. 在控制台树中,依次展开“BizTalk Server管理”、BizTalk 组、“应用程序”,然后展开要向其添加 COM 组件的应用程序。

  3. 右键单击“ 资源” 文件夹,指向 “添加”,然后单击“ 资源”。

  4. 单击“ 添加”,选择 COM 组件,然后单击“ 打开”。

  5. “文件类型 ”下拉列表中,单击“ System.BizTalk:Com”。

  6. “选项”中,根据安装应用程序时是否希望将组件添加到 Windows 注册表,选中或清除“在目标处注册文件 (regsvr32 ) 检查框。

  7. “目标”中,键入从 .msi 文件(包括文件名)安装应用程序时要复制 COM 组件的位置的完整路径。 如果未提供此路径,则在安装过程中,该文件不会复制到本地文件系统。 如果在上一步中选择了“将文件注册到目标 (regsvr32) 检查”框,则此路径是必需的。

    示例: %BTAD_InstallDir%\MyComponent.dll

  8. 完成后,单击 “确定”

使用命令行

  1. 按如下所示打开命令提示符:单击“ 开始”,单击“ 运行”,键入 cmd,然后单击“ 确定”。

  2. 键入以下命令,替换相应的值,如下表所述:

    BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Com [/Overwrite] /Source:value [/Destination:value] [/Options:Regsvr32OnInstall] [/Server:value] [/Database:value]

    例如:

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Com /Overwrite /Source:"C:\Source Components\COM.dll" /Destination:"C:\New Components\COM.dll" /Options:Regsvr32OnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb

    参数
    /ApplicationName 向其添加 COM 组件的 BizTalk 应用程序的名称。 如果未指定应用程序名称,则使用组的默认 BizTalk 应用程序。 如果名称包含空格,则必须用双引号将其括起来 (“) 。
    /类型 System.BizTalk:Com (此值不区分大小写。)
    /覆盖 更新现有 COM 组件的选项。 如果未指定此选项,且应用程序中已经存在与要添加的 COM 组件具有相同 LUID 的 COM 组件,则 AddResource 操作将失败。 可以使用 ListApp 命令查看应用程序中项目的 LUID。
    /源 COM 组件 .dll 文件的完整路径,包含文件名。 如果路径包含空格,则必须用双引号将其括起来 (“) 。
    /目的地 从 .msi 文件安装应用程序时,COM 组件 .dll 文件要复制到的位置的完整路径。 如果未提供,则安装期间该文件将不会复制到本地文件系统;因此,在安装期间该组件不会添加到 Windows 注册表中。 如果路径包含空格,则必须用双引号将其括起来 (“) 。 如果指定 Regsvr32OnInstallOption,则还必须指定 Destination。
    /选项 Regsvr32OnInstall。 指定从 .msi 文件安装应用程序时将 COM 组件添加到 Windows 注册表中。 如果指定此选项,则还必须指定 Destination。
    /服务器 BizTalk 管理数据库的宿主 SQL Server 实例的名称,格式为“服务器名称\实例名称,端口”。

    只在实例名称与服务器名称不相同时才需要指定实例名称。 只在 SQL Server 不使用默认端口号 (1433) 时才需要指定端口。

    示例:

    Server=MyServer

    Server=MyServer\MySQLServer,1533

    如果未提供,则使用本地计算机上运行的 SQL Server 实例的名称。
    /数据库 BizTalk 管理数据库的名称。 如果未指定,则使用在本地 SQL Server 实例中运行的 BizTalk 管理数据库。

另请参阅

管理 .NET 程序集、证书和其他资源
AddResource 命令:COM 组件
创建和修改 BizTalk 应用程序