C#开发Teams机器人复制表格到剪贴板功能失效问题求解

System.Windows.Forms.Clipboard是Windows桌面端本地API，仅能操作运行代码的设备的本地剪贴板：

• 本地使用Bot Framework Emulator调试时，机器人运行在你的个人电脑上，调用该API修改的是你当前设备的剪贴板，因此功能表现正常
• 部署到Microsoft Teams渠道后，机器人后端运行在远程服务端（云服务器、IIS主机等），既没有桌面UI运行上下文，也完全无法访问Teams客户端用户的本地剪贴板，不仅功能失效，还会因缺少桌面环境依赖抛出异常。

所有聊天机器人渠道都存在基础安全限制：后端服务无权直接操作用户客户端的本地剪贴板，没有任何权限绕过方式。

Teams环境下实现一键复制表格功能无需调用任何桌面端剪贴板API，依托平台原生能力即可实现，以下两种方案均经过生产环境验证：

方案1：自适应卡片原生复制动作（推荐，交互和原有逻辑完全一致） #

Teams支持1.5及以上版本自适应卡片的原生剪贴板动作，点击按钮时由客户端直接完成复制，全程不需要后端参与剪贴板操作：

1. 将自适应卡片的version字段升级为1.5或更高
2. 替换原有的Action.Submit类型复制按钮，直接在卡片动作中预置好要复制的内容（支持HTML富文本格式，粘贴到Excel/Word可自动保留表格样式），示例配置：

{
  "type": "Action.Execute",
  "title": "Copy to clipboard",
  "verb": "copyTable",
  "data": {
    "copyContent": "此处替换为你提前拼接好的HTML格式表格字符串即可"
  }
}

该动作由Teams客户端本地处理，用户点击按钮后内容会直接写入本地剪贴板，交互和你之前本地调试的效果完全一致。

方案2：选中文本复制（兼容旧版Teams客户端） #

如果需要适配不支持原生复制动作的旧版Teams客户端，可以在用户点击复制按钮后返回一张新的自适应卡片：

• 卡片中放置一个只读多行输入框，预填制表符（\t）分隔的表格内容（制表符分隔的内容粘贴到Excel时会自动匹配单元格，不会出现格式错乱）
• 配置输入框默认自动全选内容，用户仅需按下Ctrl+C/Cmd+C即可完成复制，操作成本极低。

后端拼接纯文本表格的参考代码如下，无需引用任何桌面端依赖：

var sb = new StringBuilder();
// 拼接表头，列之间用制表符分隔
sb.AppendLine("Employee ID\tName\tTitle\tCurriculum Code\tDate");
var valueToCopy = JToken.Parse(token["CopyToClipBoard"].Value<string>());
foreach(var item in valueToCopy)
{
    sb.Append($"{item["EmployeeID"].Value<string>()}\t");
    sb.Append($"{item["Name"].Value<string>()}\t");
    sb.Append($"{item["Title"].Value<string>()}\t");
    sb.Append($"{item["CurriculumCode"].Value<string>()}\t");
    sb.AppendLine(DateTime.Parse(item["Date"].Value<string>()).ToString("dd/MMM/yyyy"));
}
string tableContent = sb.ToString();
// 将该内容传入返回卡片的只读输入框即可

• 立即移除项目中对System.Windows、System.Windows.Forms的引用，服务端场景加载桌面UI依赖会提升部署出错概率，在无桌面环境的Linux服务器上会直接启动失败
• 不要尝试通过后端注入前端脚本的方式操作剪贴板，Teams客户端的安全策略会拦截所有未授权脚本执行，无法生效。

内容的提问来源于stack exchange，提问作者Xuân Hoàng