在ClosedXML中如何设置指向其他Excel文件特定单元格的超链接

问题场景 #

参考ClosedXML的官方示例，我分别实现了指向外部文件的超链接，以及指向当前工作簿内其他工作表单元格的超链接，但尝试将两者结合时遇到了问题：

官方示例代码 #

1. 指向外部文件的相对路径超链接：

ws.Cell(++ro, 1).Value = "Link to a file - relative address";
ws.Cell(ro, 1).Hyperlink = new XLHyperlink(@"../Test.xlsx");

2. 指向当前工作簿内其他工作表单元格的超链接：

ws.Cell(++ro, 1).Value = "Link to an address in another worksheet";
ws.Cell(ro, 1).Hyperlink = new XLHyperlink("'Second Sheet'!A1");

错误尝试 #

我尝试组合两种场景，实现指向外部文件特定单元格的超链接，但代码无法正常工作，点击生成的Excel单元格时提示无法打开指定文件：

ws.Cell(++ro, 1).Value = "Link to an address in another file - worksheet-cell";
ws.Cell(ro, 1).Hyperlink = new XLHyperlink("@../Test.xlsx'Second Sheet'!A1"); // 无效代码

注：ClosedXML 0.96.0及以上版本已移除ws.Cell(ro, 1).Hyperlink属性，改用SetHyperlink()方法后仍出现相同错误。

临时解决方案（非原生超链接） #

目前通过Excel的HYPERLINK公式实现了跳转，但这并非原生超链接，默认没有蓝色下划线样式，点击后也不会变为红色，需要手动设置单元格格式：

ws.Cell(ro, 1).FormulaA1 = $"HYPERLINK(\"[{@../Test.xlsx}]'Second Sheet'!A5\",\"Hello\")";

正确的原生超链接实现 #

要创建原生的外部文件单元格超链接，需要遵循Excel的标准外部引用格式：[文件路径]工作表名!单元格地址，ClosedXML支持这种格式的超链接目标。

代码示例（ClosedXML 0.96.0+） #

// 定义目标文件路径和单元格引用
var targetFile = @"../Test.xlsx";
var targetCell = "'Second Sheet'!A1";
// 组合成Excel标准的外部引用格式
var hyperlinkTarget = $"[{targetFile}]{targetCell}";

// 设置单元格内容和原生超链接
ws.Cell(++ro, 1).Value = "跳转到外部文件的指定单元格";
ws.Cell(ro, 1).SetHyperlink(new XLHyperlink(hyperlinkTarget));

路径包含特殊字符的处理 #

如果目标文件路径包含空格或特殊字符，需要给路径加上单引号：

var targetFile = @"../我的测试文件.xlsx";
var hyperlinkTarget = $@"'{targetFile}'{targetCell}";

使用这种方式生成的超链接是Excel原生的，会自动应用蓝色下划线样式，点击跳转后链接文本会变为红色，无需手动设置格式。

内容的提问来源于stack exchange，提问作者Senna