跳转至

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}");

输出:

https://example.com internal=False tooltip=Visit Example

超链接的显示效果见[第 7 章](layout.md)的截图。