如何配置 WCF-Custom 接收处理程序

如果希望 WCF-Custom 适配器从 machine.config 以外的位置查找自定义行为扩展,则必须配置接收处理程序属性。

为什么 WCF-Custom 适配器要从 machine.config 之外的位置查找自定义行为扩展?

BizTalk Server 中使用的自定义行为扩展是在 machine.config 中注册的。在加载行为扩展之前,WCF-Custom 适配器将在 machine.config 中查找行为扩展。不过,machine.config 最好用于存储在特定计算机上运行的所有应用程序所需的配置信息。 另一方面,WCF 自定义行为扩展可能只需要 BizTalk Server,而不是由计算机上运行的所有应用程序所必需的。 因此,在 machine.config 中存储自定义行为扩展时,它不是最佳的位置。

使用 BizTalk Server,适配器处理程序属性提供了一个附加位置,WCF-Custom 适配器可在该位置查找自定义行为扩展。 请注意,这不会替换 machine.config 中已有的行为扩展。

其他注意事项

配置 WCF-Custom 接收处理程序属性时应注意以下几点:

  • 自定义行为扩展必须在 machine.config 或适配器处理程序属性中可用。 不能在这两个位置复制自定义行为扩展。

  • 如果自定义行为扩展在 machine.config 中已可用,并且您尝试为适配器处理程序属性设置相同的行为扩展,则在您尝试设置该属性时,将会出现错误。

  • 如果已经为适配器处理程序属性设置了自定义行为扩展,然后用同样的行为扩展更新 machine.config 时,会收到运行时错误,并且还会在事件日志中记录此错误。 接收位置也被禁用。

  • 自定义行为扩展中引用的程序集必须存在于全局程序集缓存 (GAC) ,然后才能设置适配器处理程序属性。

配置适配器处理程序属性

使用本主题中的步骤可配置 WCF-Custom 接收处理程序。

配置适配器处理程序属性

  1. 在 BizTalk 管理控制台中,依次展开 " BizTalk Server管理"、" BizTalk 组"、"平台" 设置和 "适配器"。

  2. 在展开的适配器列表中,单击 " WCF-自定义",在右窗格中右键单击要配置的接收处理程序,然后单击 " 属性"。

  3. 在 " 适配器处理程序属性 " 对话框的 " 常规 " 选项卡上的 " 主机名 " 列表中,选择接收处理程序将与之关联的主机,然后单击 " 属性"。

  4. 在 " wcf-自定义传输属性 " 对话框中的 " wcf 扩展 " 选项卡上,执行以下操作:

    使用此选项 要执行此操作
    导入 导入带有 WCF 自定义行为扩展的 WCF 配置文件。 单击此按钮将打开 " 导入 wcf 配置 " 对话框,以浏览并找到 WCF 配置文件。 请注意,该文件应该是有效的 WCF 配置文件。 有关 WCF 配置架构的详细信息,请参阅中的 "Windows Communication Foundation 配置架构" https://go.microsoft.com/fwlink/?LinkId=163953
    导出 将 WCF 自定义行为扩展导出到 WCF 配置文件。 单击此按钮将打开 " 导出 wcf 配置 " 对话框,以浏览并保存 WCF 配置文件。
    Clear 从适配器处理程序属性中清除现有 WCF 自定义行为扩展。

另请参阅

配置 WCF-Custom 适配器