从 Visual Studio 工具箱添加和删除自定义 Functoid

  • 项目

本主题介绍如何向 Visual Studio 工具箱添加自定义 functoid 以及从中删除自定义 functoid。

向 Visual Studio 添加自定义 functoid

自定义 functoid 只有在添加到 Visual Studio 工具箱后才可以在映射中使用。 使用以下过程可以添加自定义 functoid。

添加自定义 functoid

  1. 向 Visual Studio 工具箱添加 functoid。

    1. 用 Windows 资源管理器找到实现自定义 functoid 的程序集。

    2. 将程序集复制到<BizTalk Server安装文件夹>\Developer Tools\Mapper Extensions 目录。 这是 BizTalk 映射器查找自定义 functoid 的位置。

    3. 在 Visual Studio BizTalk 项目中，在“ 工具 ”菜单上，单击“ 选择工具箱项”。

    4. 在 “选择工具箱项 ”对话框中，单击“ BizTalk Mapper Functoid ”选项卡。

    5. 单击“ 重置”，然后单击“ 确定”。 此进程可能需要花费一些时间。

      现在，自定义 functoid 应该出现在工具箱中的与其类别相匹配的选项卡下。

      - 或者 -

    6. 在 Visual Studio BizTalk 项目中，在“ 工具 ”菜单上，单击“ 选择工具箱项”。

    7. 在 “选择工具箱项 ”对话框中，单击“ BizTalk Mapper Functoid ”选项卡。

    8. 单击“ 重置”，然后单击“ 确定”。

      注意

      如果自定义 functoid 没有公开任何内联代码，请确保全局程序集缓存中包含其程序集。

    9. 在“ 文件 ”菜单上，单击“ 退出 ”关闭 Visual Studio。

    10. 启动 Visual Studio 命令提示符。

    11. 在命令提示符下，键入 devenv /setup。

    12. 启动 Microsoft Visual Studio。

      此时自定义 functoid 应出现在相应的选项卡中。

  2. 将相应程序集添加到全局程序集缓存中。 如果程序集只包含内联 functoid，则可以跳过此步骤。

    1. 启动 Visual Studio 命令提示符。

    2. 切换到包含你的程序集的文件夹。

    3. 在命令提示符下，键入 gacutil /if <assembly_path >。 例如，如果程序集名称 FunctoidLibrary.dll，则键入 gacutil /if FunctoidLibrary.dll。

    4. 完成后，键入 exit。

从 Visual Studio 中删除自定义 functoid

使用以下过程可以删除自定义 functoid。

删除自定义 functoid

  1. 从 Visual Studio 工具箱中删除 functoid。

    1. 在 Visual Studio BizTalk 项目中，在“ 工具 ”菜单上，单击“ 选择工具箱项”。

    2. 在 “选择工具箱项 ”对话框中，单击“ BizTalk Mapper Functoid ”选项卡。

    3. 在列表中找到自定义 functoid，选择“删除检查”框，然后单击“确定”。

      - 或者 -

    4. 在 Visual Studio BizTalk 项目中编辑地图时，单击“ 工具箱” 选项卡以显示“工具箱面板”。

    5. 单击包含自定义 functoid 的 functoid 组。

    6. 右键单击要删除的 functoid，然后单击“ 删除 ”或按删除键。

  2. 从 Developer Tools\Mapper Extensions 目录中删除 functoid 程序集。

    注意

    如果程序集包含活动的 functoid，请不要删除它。 因为这样做将中断其他映射。

    1. 启动 Windows 资源管理器并导航到 BizTalk Server 的 Developer Tools\Mapper Extensions 目录。

    2. 右键单击包含已删除 functoid 的程序集，然后单击“ 删除 ”删除该文件。

  3. 从全局程序集缓存中删除 functoid 程序集。 如果程序集只包含内联 functoid，则可以跳过此步骤。

    注意

    如果该程序集包含活动的 functoid，请不要从全局程序集缓存中删除它。 因为这样做将中断其他映射。

    1. 启动 Visual Studio 命令提示符。

    2. 在命令提示符下，键入 gacutil /u <assembly_display_name>。 例如，如果程序集名称 FunctoidLibrary.dll，则键入 gacutil /if FunctoidLibrary。

    3. 完成后，键入 exit。

另请参阅

开发自定义 Functoid