自定义 Functoid（BizTalk Server 示例）
自定义 functoid 示例演示如何为 BizTalk 映射器编写自定义 functoid。 您可以向 Visual Studio 工具箱添加此 functoid。 当 BizTalk 映射器获得焦点时，该 functoid 将显示在工具箱中。
自定义 functoid 应位于 BizTalk 映射器程序集中以便识别。 它可以使用任何一种符合 .NET 的语言进行编写，例如 C# 或 Visual Basic。
此外，自定义 functoid 必须派生自 Microsoft.BizTalk.BaseFunctoids 类，并且它必须通过重写某些方法为它们提供实现。 (类BaseFunctoid在 BizTalk Server.) 随附的 Microsoft.BizTalk.BaseFunctoids.dll 程序集中定义
本示例的用途
自定义 Functoid 示例实现多个 functoid，每个 functoid 都派生自 BaseFunctoid 类并重写多个方法。
实现自定义 functoid 时，可以公开其内联代码。 内联代码负责为 functoid 执行计算。 BizTalk 映射器的编译器从 functoid 提取内联代码，并在生成项目时将其嵌入编译的 XSLT 中。
如果自定义 functoid 不公开任何内联代码，则 BizTalk 映射器将生成调用自定义 functoid 所在程序集的 XSLT。 在此情况下，必须确保自定义 functoid 程序集在全局程序集缓存中可用，以便 XSLT 引擎能够找到它。 自定义 functoid 还必须具有唯一的 GUID 属性。 BizTalk 映射器使用 GUID 标识要加载的程序集。
重要
如果你重用自定义 functoid 示例代码以实现自己的 functoid，则必须确保将 GUID 属性更改为唯一值。
本示例所在的位置
<示例 Path>\XmlTools\CustomFunctoid
下表显示了本示例中的文件及其用途说明：
| 文件 | 说明 |
|---|---|
| AssemblyInfo.cs | 程序集信息 C# 源代码。 |
| CBuildArray.bmp | 工具箱位图。 |
| CConcat.bmp | 工具箱位图。 |
| CExtractArray.bmp | 工具箱位图。 |
| Cleanup.bat | 用于取消部署程序集并从全局程序集缓存 (GAC) 删除这些程序集，同时删除 CustomFunctoid.dll。 |
| CLongestString.bmp | 工具箱位图。 |
| CMultiply.bmp | 工具箱位图。 |
| CustomFunctoid.cs | 自定义 functoid C# 源代码。 |
| CustomFunctoid.csproj | 自定义 functoid C# 项目。 |
| CustomFunctoid.sln | 自定义 functoid 解决方案。 |
| CustomFunctoidResources.resx | 自定义 functoid 资源。 |
| Setup.bat | 用于生成、部署和启动示例。 |
生成和初始化此示例
使用以下过程可以生成并初始化自定义 functoid 示例。
构建和初始化此示例
在命令窗口中，将 目录 (cd) 更改为以下文件夹：
<示例路径>\XmlTools\CustomFunctoid
运行 Setup.bat 文件，该文件将执行以下操作：
生成示例项目。
将生成的程序集复制到 Developer Tools\Mapper Extensions 目录中。
向 GAC 添加生成的程序集。
注意
在尝试运行本示例前，你应确认在生成和初始化过程中未报告任何错误。
运行本示例
使用以下过程运行自定义 functoid 示例。
运行本示例的步骤
在 Visual Studio BizTalk 项目中，单击“ 工具” 菜单，然后选择“ 选择工具箱项”。
在 “选择工具箱项 ”对话框中，选择“ BizTalk 映射程序”“Functoid ”选项卡。
单击 “重置”，然后单击“ 确定”。
注意
如果自定义 functoid 没有公开任何内联代码，请确保 GAC 中包含其程序集。
从“ 文件 ”菜单中选择“ 退出 ”以关闭 Visual Studio。
启动 Visual Studio 命令提示符。
在命令提示符下，键入 devenv /setup。
启动 Microsoft Visual Studio。
自定义 functoid (自定义串联 functoid、Longest String、Build array functoid 和 Extract array functoid) 显示在“工具箱”的“ 字符串 Functoid ”选项卡上，“累积乘法”functoid 显示在“ 累积 Functoid ”选项卡上。
删除此示例
使用以下过程可以删除此自定义 functoid 示例。
删除本示例
从 Visual Studio 工具箱中删除此 functoid。
警告
如果在运行 Cleanup.bat 后，仍在工具箱中看到过时的自定义 functoid（可能是由于 Visual Studio 内部缓存），请按照下面的步骤进行操作：
在 Visual Studio BizTalk 项目中，单击“ 工具” 菜单，然后选择“ 选择工具箱项”。
在 “选择工具箱项 ”对话框中，选择“ BizTalk 映射程序”“Functoid ”选项卡。
在列表中找到自定义 functoid（“自定义连接”functoid、“最长字符串”、“构建数组”functoid、“提取数组”functoid 和“累计乘”）。 单击相应的检查框以删除 functoid，然后单击“确定”。
如果上述过程不起作用，则执行以下过程。
在 Visual Studio BizTalk 项目中，单击 “工具箱” 选项卡，同时编辑地图以显示“工具箱面板”。
右键单击工具箱，然后选择“ 选择项”。
在“选择项”对话框中，单击“ 重置”，然后单击“ 确定”。
关闭 Visual Studio 的所有实例。
如果上述过程不起作用，则执行以下过程。
以管理员身份启动 Visual Studio 命令提示符 。
关闭所有正在运行的 Visual Studio 的实例。
提供以下命令：
devenv /resetsettingsdevenv /setup可以从工具箱中手动选择不需要的 functoid。 然后，右键单击 functoid，然后单击“ 删除”。
如果上述过程不起作用，则执行以下过程。
在 Visual Studio BizTalk 项目中编辑映射时，单击“工具箱”选项卡打开工具箱面板。
单击“ 累积 Functoid” 组。
右键单击要删除的 functoid，然后选择 “删除” 或按删除键。
单击“ 字符串 Functoid” 组。
右键单击要删除的 functoid，然后选择 “删除” 或按删除键。
在命令窗口中，将目录 (cd) 更改为以下文件夹：
<示例路径>\XmlTools\CustomFunctoid
运行 Cleanup.bat 文件，该文件将执行以下操作：
从 Developer Tools\Mapper Extensions 目录中删除程序集。
从 GAC 删除程序集。
本示例中使用的类或方法
Microsoft.BizTalk.BaseFunctoids.BaseFunctoid