如何用SharePoint Online CSOM为列表项添加文档库子文件夹超链接

在SharePoint CSOM中，超链接类型的字段需要通过FieldUrlValue对象来赋值，该对象包含超链接的地址（Url）和显示文本（Description）两个核心属性。具体操作步骤如下：

1. 修正文件夹创建代码，获取新建子文件夹的地址 #

你当前创建文件夹的代码存在重复调用（同时用了AddSubFolder和Folders.Add），建议改为以下方式，直接获取新建的子文件夹对象并加载其路径：

// 创建子文件夹并获取对象
Folder newSubFolder = parentFolder.Folders.Add(newSubFolderName);
clientContext.Load(newSubFolder, f => f.ServerRelativeUrl);
clientContext.ExecuteQuery();

2. 构造超链接字段值并赋值给列表项 #

通过FieldUrlValue构造超链接内容，然后赋值给列表项的File字段：

// 构造超链接对象
FieldUrlValue folderLink = new FieldUrlValue();
// 设置超链接地址：可以用绝对路径（拼接web的AbsoluteUrl）或服务器相对路径
folderLink.Url = clientContext.Web.AbsoluteUrl + newSubFolder.ServerRelativeUrl;
// 设置超链接显示文本（可以自定义，比如用文件夹名称）
folderLink.Description = newSubFolderName;

// 赋值给列表项的"File"字段
oListItem["File"] = folderLink;

完整修正后的关键代码片段 #

Web web = clientContext.Web;
clientContext.Load(web, a => a.ServerRelativeUrl, a => a.AbsoluteUrl);
clientContext.ExecuteQuery();

// 创建子文件夹
Folder parentFolder = web.GetFolderByServerRelativeUrl(web.ServerRelativeUrl + "/" + parentFolderPath);
clientContext.Load(parentFolder);
clientContext.ExecuteQuery();

// 获取新建的子文件夹对象
Folder newSubFolder = parentFolder.Folders.Add(newSubFolderName);
clientContext.Load(newSubFolder, f => f.ServerRelativeUrl);
clientContext.ExecuteQuery();

// 创建列表项并添加超链接
List targetList = clientContext.Web.Lists.GetByTitle(listName);
ListItemCreationInformation itemCreateInfo = new ListItemCreationInformation();
ListItem oListItem = targetList.AddItem(itemCreateInfo);

// 构造超链接
FieldUrlValue folderLink = new FieldUrlValue();
folderLink.Url = web.AbsoluteUrl + newSubFolder.ServerRelativeUrl;
folderLink.Description = newSubFolderName;
oListItem["File"] = folderLink;

oListItem.Update();
clientContext.ExecuteQuery();

说明 #

• FieldUrlValue.Url既可以使用绝对路径（如上示例），也可以直接使用服务器相对路径（newSubFolder.ServerRelativeUrl），SharePoint会自动识别并处理
• Description是超链接的显示文本，可根据需求自定义（比如用文件夹名称、特定说明文字等）

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