BizTalk Mapper中脚本Functoid需用沙箱安全的C#代码，仅支持string等基础类型和特定类；DateTime.ParseExact需传null消除重载歧义；外部方法须static、强命名并注册GAC；空值和编码处理不当易致输出异常。
如何在 BizTalk Mapper 中正确调用 C# 脚本 Functoid
脚本 Functoid 本质是把一段 C# 代码编译进 XSLT，不是直接执行 .NET 方法。这意味着你不能依赖 System.IO、HttpClient 或任何非沙箱安全的类——BizTalk 的 XSLT 引擎运行在受限上下文里。
必须使用 System.Xml.Xsl.XsltContext 允许的类型，常见可用的有：string、int、bool、DateTime、Math、Convert、Regex（需用 System.Text.RegularExpressions 显式引入）。
- 在 Functoid 属性中选择「Script Type」为
Inline C#或External Method；后者要求方法是static且参数/返回值都为基本类型 - 若选
Inline C#，所有代码会被包裹进一个自动生成的public static string ScriptFun1(string param1, ...)方法中，不要写 class、namespace 或 using（除了using System.Text.RegularExpressions;这类明确被支持的） - 返回值必须是
string，即使你做数值计算，也得用return result.ToString();
为什么 DateTime.ParseExact 在脚本 Functoid 里总报错
这不是语法问题，而是 BizTalk XSLT 引擎对重载方法解析失败的典型表现。它无法区分 DateTime.ParseExact(string, string, IFormatProvider) 和带 DateTimeStyles 的重载版本。
解决办法是避免调用含可选参数或多个重载的方法，改用更明确的等价写法：
dingtalk-docs
下载
管理钉钉云文档中的文档、文件夹和内容。适用于创建、搜索、读取或写入文档、创建文件夹整理。也适用于提及云文档、在线文档、钉钉文档、钉文档等关键词的场景。不要在操作多维表、日程、消息或审批流时触发。
string input = (string)param1;
if (string.IsNullOrEmpty(input)) return string.Empty;
try {
DateTime dt = DateTime.ParseExact(input, "yyyyMMddHHmmss", null);
return dt.ToString("yyyy-MM-ddTHH:mm:ss");
}
catch {
return string.Empty;
}- 强制传
null作为IFormatProvider参数，消除重载歧义 - 不用
CultureInfo.InvariantCulture—— 它在沙箱中不可用 - 所有异常必须捕获，否则整个 map 执行会中断并抛出
XsltCompileException
外部方法 Functoid 如何传递多个字段并保持类型安全
外部方法不是“引用 DLL”那么简单。BizTalk 要求方法签名完全匹配：参数顺序、数量、类型，且返回类型只能是 string。如果源节点是日期+字符串+整数，你得定义：
public static string BuildKey(string dateStr, string code, string seqNum) {
int num;
if (!int.TryParse(seqNum, out num)) num = 0;
return $"{dateStr}_{code}_{num:D6}";
}- 所有入参在 XSLT 层都是
string类型，即使源字段是xs:date或xs:integer，Mapper 会自动转成字符串传入 - 方法必须声明为
public static，放在Microsoft.BizTalk.Mapper.Extensions命名空间下（或任意命名空间，但需在 GAC 或 BTS 程序集路径中注册） - 部署时，DLL 必须强名称签名，并用
gacutil /i安装到 GAC，仅放 bin 目录无效
调试脚本 Functoid 输出为空或乱码的常见原因
最常被忽略的是编码和空值处理逻辑。XSLT 引擎对 null 字符串不友好，传入 null 会导致整个函数返回空，且无日志提示。
- 永远对每个
paramN做== null || string.IsNullOrEmpty((string)paramN)判断 - 避免在脚本中拼接 XML 片段（如
"<item>" + val + "</item>"），XSLT 会把它当纯文本转义，输出变成<item>...</item> - 测试时，在 Functoid 后连一个
String ConcatenateFunctoid 并接常量"DEBUG:"，可快速确认是否执行到该脚本 - 真正有效的调试方式是：在外部方法中写 Windows Event Log（需权限），或用
System.Diagnostics.Debug.WriteLine（仅开发机有效，生产环境不输出）
脚本 Functoid 的边界比看起来窄得多——它不是 C# 编辑器，而是 XSLT 的一道语法糖封装。越早接受“只能做轻量字符串/数值转换”，越少掉进重试、超时、GAC 加载失败这些隐蔽坑里。
