SharePoint Online：从文档库URL提取文件夹路径的技术问询

嘿，作为SharePoint Online新手，我完全理解你想要用规范方式解析文档库URL、避免正则的需求！下面给你两种靠谱的实现思路，都是官方推荐或者更稳定的方案：

CSOM是微软官方提供的SharePoint开发工具包，能帮你准确识别站点和文件夹的结构，完全不用担心URL格式变化的问题。

首先你需要先安装NuGet包：Microsoft.SharePointOnline.CSOM

然后用以下代码实现：

using Microsoft.SharePoint.Client;
using System;
using System.Security;

class SharePointFileRetriever
{
    static void Main(string[] args)
    {
        // 替换成你的文档库AllItems.aspx URL
        string allItemsUrl = "https://customer2.sharepoint.com/sites/sitename/DocumentFolder/SubFolder/Forms/AllItems.aspx";
        string username = "your-account@customer2.onmicrosoft.com";
        string password = "your-password";

        // 移除URL中的Forms/AllItems.aspx后缀，得到文件夹的基础URL
        string folderBaseUrl = allItemsUrl.Replace("/Forms/AllItems.aspx", "");

        // 获取站点根URL
        string siteUrl = GetSiteRootUrl(folderBaseUrl, username, password);

        // 初始化ClientContext
        using (ClientContext context = new ClientContext(siteUrl))
        {
            // 设置SharePoint Online凭据
            SecureString securePassword = new SecureString();
            foreach (char c in password) securePassword.AppendChar(c);
            context.Credentials = new SharePointOnlineCredentials(username, securePassword);

            // 获取文件夹的服务器相对路径
            string folderRelativePath = GetServerRelativeFolderPath(new Uri(folderBaseUrl), siteUrl);

            // 调用REST API的等价CSOM操作（或者直接构造REST请求）
            Folder targetFolder = context.Web.GetFolderByServerRelativeUrl(folderRelativePath);
            context.Load(targetFolder.Files); // 加载文件夹下的所有文件
            context.ExecuteQuery();

            // 输出文件列表
            Console.WriteLine("文件夹下的文件：");
            foreach (File file in targetFolder.Files)
            {
                Console.WriteLine($"- {file.Name}");
            }

            // 如果要直接构造REST API URL
            string encodedPath = Uri.EscapeDataString(folderRelativePath);
            string restApiUrl = $"{siteUrl}/_api/web/GetFolderByServerRelativeUrl('{encodedPath}')";
            Console.WriteLine($"\n对应的REST API URL：{restApiUrl}");
        }
    }

    // 通过CSOM获取站点的根URL（自动识别根站点/子站点）
    static string GetSiteRootUrl(string folderUrl, string username, string password)
    {
        using (ClientContext tempContext = new ClientContext(folderUrl))
        {
            SecureString securePassword = new SecureString();
            foreach (char c in password) securePassword.AppendChar(c);
            tempContext.Credentials = new SharePointOnlineCredentials(username, securePassword);

            tempContext.Load(tempContext.Web, web => web.Url);
            tempContext.ExecuteQuery();

            return tempContext.Web.Url;
        }
    }

    // 计算文件夹的服务器相对路径
    static string GetServerRelativeFolderPath(Uri folderUri, string siteUrl)
    {
        Uri siteUri = new Uri(siteUrl);
        string siteAbsolutePath = siteUri.AbsolutePath;
        string folderAbsolutePath = folderUri.AbsolutePath;

        // 提取站点路径之外的部分作为文件夹相对路径
        if (folderAbsolutePath.StartsWith(siteAbsolutePath))
        {
            string relativePath = folderAbsolutePath.Substring(siteAbsolutePath.Length);
            return string.IsNullOrEmpty(relativePath) ? "/" : (relativePath.StartsWith("/") ? relativePath : $"/{relativePath}");
        }
        return folderAbsolutePath;
    }
}

这个方案的优势是完全依赖SharePoint官方API，不管你的站点是根站点还是嵌套子站点，都能准确解析出正确的路径，不会因为URL结构变化出错。

如果你不想引入CSOM依赖，也可以利用SharePoint文档库URL的固定规律（/Forms/AllItems.aspx是列表视图的固定后缀），结合Uri类来拆分，比正则更稳定：

using System;

class SharePointUrlParser
{
    static void Main(string[] args)
    {
        TestUrlParser("https://customer1.sharepoint.com/DocumentFolder/Forms/AllItems.aspx");
        TestUrlParser("https://customer2.sharepoint.com/sites/sitename/DocumentFolder/SubFolder/Forms/AllItems.aspx");
    }

    static void TestUrlParser(string allItemsUrl)
    {
        // 移除固定后缀，得到文件夹的基础URL
        string folderBaseUrl = allItemsUrl.Replace("/Forms/AllItems.aspx", "");
        Uri folderUri = new Uri(folderBaseUrl);

        string siteUrl;
        string folderRelativePath;

        if (folderUri.AbsolutePath.Contains("/sites/"))
        {
            // 处理子站点场景：拆分出/sites/后的站点部分
            int sitesSegmentStart = folderUri.AbsolutePath.IndexOf("/sites/") + "/sites/".Length;
            int nextSlashIndex = folderUri.AbsolutePath.IndexOf("/", sitesSegmentStart);

            if (nextSlashIndex == -1)
            {
                // 站点本身就是/sites/sitename，没有子文件夹
                siteUrl = $"{folderUri.Scheme}://{folderUri.Host}{folderUri.AbsolutePath}";
                folderRelativePath = "/";
            }
            else
            {
                string siteAbsolutePath = folderUri.AbsolutePath.Substring(0, nextSlashIndex);
                siteUrl = $"{folderUri.Scheme}://{folderUri.Host}{siteAbsolutePath}";
                folderRelativePath = folderUri.AbsolutePath.Substring(nextSlashIndex);
            }
        }
        else
        {
            // 处理根站点场景
            siteUrl = $"{folderUri.Scheme}://{folderUri.Host}";
            folderRelativePath = folderUri.AbsolutePath;
        }

        // 输出结果
        Console.WriteLine($"原URL：{allItemsUrl}");
        Console.WriteLine($"站点URL：{siteUrl}");
        Console.WriteLine($"文件夹相对路径：{folderRelativePath}");
        Console.WriteLine($"REST API URL：{siteUrl}/_api/web/GetFolderByServerRelativeUrl('{Uri.EscapeDataString(folderRelativePath)}')");
        Console.WriteLine("---");
    }
}

这个方案的优势是轻量，不需要额外依赖，但需要注意：如果你的SharePoint环境有自定义的视图URL（不是默认的AllItems.aspx），这个方法需要调整后缀匹配逻辑。

额外提示 #

构造REST API请求时，记得用Uri.EscapeDataString()对文件夹路径进行编码，避免路径中的空格、特殊字符导致请求失败。

内容的提问来源于stack exchange，提问作者Senthil Kumar Kandasamy