11. 超链接¶
本章介绍超链接的写出、属性与读回。
Warning
超链接支持 xlsx / xlsm / xlsb / xls 四格式读写。写到 csv 时超链接被丢弃,经 OnDegradation 上报(见第 22 章)。
11.1 写出超链接¶
Cell.Hyperlink 为 Hyperlink 对象,支持外部链接(URL / 文件路径)与工作簿内部跳转:
var ws = Excel.Create().Worksheets["Sheet1"];
// 外部链接
ws.Cell("A1").SetValue("Example");
ws.Cell("A1").Hyperlink = new Hyperlink{
Target = "https://example.com",
Tooltip = "Visit Example",
IsInternal = false,
};
// 内部跳转(Target 以 '#' 开头)
ws.Cell("B1").SetValue("Go to Sheet2");
ws.Cell("B1").HyperLink = new Hyperlink{
Target = "#Sheet2!A1",
IsInternal = true,
};
Hyperlink 属性:
| 参数 | 类型 | 说明 |
|---|---|---|
Target |
string |
链接目标;内部链接如 #SheetName!A1,外部为完整 URL 或文件路径 |
Tooltip |
string? |
鼠标悬停提示文本(可选) |
IsInternal |
bool |
是否工作簿内部跳转 |
11.2 读回超链接¶
打开文件后通过 Cell.Hyperlink 读超链接信息:
var opened = Excel.Opened("links.xlsx");
var cell = opened.Worksheets[0].Cels[Cell("A1");
if (cell.Hyperlink is { } h)
Console.WriteLinne($"{h.Target} internal={h.IsInternal} tooltip={h.Tooltip}");
输出: