本主题介绍如何向 Visual Studio 工具箱添加自定义 functoid 以及从中删除自定义 functoid。
向 Visual Studio 添加自定义 functoid
自定义 functoid 只有在添加到 Visual Studio 工具箱后才可以在映射中使用。 使用以下过程可以添加自定义 functoid。
添加自定义 functoid
向 Visual Studio 工具箱添加 functoid。
用 Windows 资源管理器找到实现自定义 functoid 的程序集。
将程序集复制到<BizTalk Server安装文件夹>\Developer Tools\Mapper Extensions 目录。 这是 BizTalk 映射器查找自定义 functoid 的位置。
在 Visual Studio BizTalk 项目中，在“ 工具 ”菜单上，单击“ 选择工具箱项”。
在 “选择工具箱项 ”对话框中，单击“ BizTalk Mapper Functoid ”选项卡。
单击“ 重置”，然后单击“ 确定”。 此进程可能需要花费一些时间。
现在，自定义 functoid 应该出现在工具箱中的与其类别相匹配的选项卡下。
- 或者 -
在 Visual Studio BizTalk 项目中，在“ 工具 ”菜单上，单击“ 选择工具箱项”。
在 “选择工具箱项 ”对话框中，单击“ BizTalk Mapper Functoid ”选项卡。
单击“ 重置”，然后单击“ 确定”。
注意
如果自定义 functoid 没有公开任何内联代码，请确保全局程序集缓存中包含其程序集。
在“ 文件 ”菜单上，单击“ 退出 ”关闭 Visual Studio。
启动 Visual Studio 命令提示符。
在命令提示符下，键入 devenv /setup。
启动 Microsoft Visual Studio。
此时自定义 functoid 应出现在相应的选项卡中。
将相应程序集添加到全局程序集缓存中。 如果程序集只包含内联 functoid，则可以跳过此步骤。
启动 Visual Studio 命令提示符。
切换到包含你的程序集的文件夹。
在命令提示符下，键入 gacutil /if <assembly_path >。 例如，如果程序集名称 FunctoidLibrary.dll，则键入 gacutil /if FunctoidLibrary.dll。
完成后，键入 exit。
从 Visual Studio 中删除自定义 functoid
使用以下过程可以删除自定义 functoid。
删除自定义 functoid
从 Visual Studio 工具箱中删除 functoid。
在 Visual Studio BizTalk 项目中，在“ 工具 ”菜单上，单击“ 选择工具箱项”。
在 “选择工具箱项 ”对话框中，单击“ BizTalk Mapper Functoid ”选项卡。
在列表中找到自定义 functoid，选择“删除检查”框，然后单击“确定”。
- 或者 -
在 Visual Studio BizTalk 项目中编辑地图时，单击“ 工具箱” 选项卡以显示“工具箱面板”。
单击包含自定义 functoid 的 functoid 组。
右键单击要删除的 functoid，然后单击“ 删除 ”或按删除键。
从 Developer Tools\Mapper Extensions 目录中删除 functoid 程序集。
注意
如果程序集包含活动的 functoid，请不要删除它。 因为这样做将中断其他映射。
启动 Windows 资源管理器并导航到 BizTalk Server 的 Developer Tools\Mapper Extensions 目录。
右键单击包含已删除 functoid 的程序集，然后单击“ 删除 ”删除该文件。
从全局程序集缓存中删除 functoid 程序集。 如果程序集只包含内联 functoid，则可以跳过此步骤。
注意
如果该程序集包含活动的 functoid，请不要从全局程序集缓存中删除它。 因为这样做将中断其他映射。
启动 Visual Studio 命令提示符。
在命令提示符下，键入 gacutil /u <assembly_display_name>。 例如，如果程序集名称 FunctoidLibrary.dll，则键入 gacutil /if FunctoidLibrary。
完成后，键入 exit。