如何解决ASP.NET Web Forms从SharePoint获取文档限30条的问题？

嘿，我太懂你这种维护老ASP.NET Web Forms系统，还要碰完全陌生的SharePoint的抓狂感了！别慌，这个最多返回30条的问题其实是SharePoint的默认分页限制——不管你用哪种方式调用它的接口，默认只返回第一页的30条数据。咱们直接上解决方案，不用纠结太多SharePoint的底层细节。

方法1：用SharePoint客户端对象模型（CSOM）——最适合Web Forms的方案 #

这是.NET项目对接SharePoint最常用的方式，兼容性好，代码也直观。

第一步：先加CSOM引用 #

打开你的项目的NuGet包管理器，搜索Microsoft.SharePointOnline.CSOM（如果是本地部署的SharePoint，就搜Microsoft.SharePoint.Client），安装一个和你的SharePoint版本兼容的版本（不知道版本的话装最新稳定版就行）。

第二步：写分页获取所有文档的代码 #

在你的页面后台（比如YourPage.aspx.cs）里，加一个方法来遍历所有分页的数据：

using Microsoft.SharePoint.Client;
using System;
using System.Collections.Generic;
using System.Linq;

// 传入SharePoint站点地址、文档库名称、当前客户ID，返回所有关联的文档
public List<ListItem> GetAllCustomerDocs(string spSiteUrl, string docLibraryName, string currentCustomerId)
{
    var allDocs = new List<ListItem>();
    
    // 建立SharePoint连接
    using (var clientCtx = new ClientContext(spSiteUrl))
    {
        // 这里加身份验证：如果是SharePoint Online，用用户名密码；本地的话可能用Windows身份
        // 示例：SharePoint Online的身份验证
        // var securePassword = new System.Security.SecureString();
        // foreach (char c in "你的密码") securePassword.AppendChar(c);
        // clientCtx.Credentials = new SharePointOnlineCredentials("你的账号@xxx.onmicrosoft.com", securePassword);

        // 获取目标文档库
        List docList = clientCtx.Web.Lists.GetByTitle(docLibraryName);
        
        // 构造查询：筛选出和当前客户关联的文档（这里假设你有个叫CustomerId的字段存客户标识）
        CamlQuery query = new CamlQuery();
        // 把每页条数调大到500（SharePoint允许的最大值），减少分页次数
        query.ViewXml = $@"<View>
                            <Query>
                                <Where>
                                    <Eq>
                                        <FieldRef Name='CustomerId' />
                                        <Value Type='Text'>{currentCustomerId}</Value>
                                    </Eq>
                                </Where>
                            </Query>
                            <RowLimit>500</RowLimit>
                          </View>";

        ListItemCollectionPosition pagePosition = null;
        do
        {
            query.ListItemCollectionPosition = pagePosition; // 设置当前要获取的页位置
            ListItemCollection pageItems = docList.GetItems(query);
            clientCtx.Load(pageItems);
            clientCtx.ExecuteQuery(); // 执行查询
            
            allDocs.AddRange(pageItems.ToList()); // 把当前页的文档加入总列表
            pagePosition = pageItems.ListItemCollectionPosition; // 获取下一页的标记

        } while (pagePosition != null); // 直到没有下一页为止

        return allDocs;
    }
}

第三步：在页面上调用并展示 #

把获取到的文档绑定到GridView、Repeater这些Web Forms常用控件上就行：

protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        // 从页面或者Session里拿到当前客户的ID
        string customerId = Request.QueryString["CustomerId"] ?? Session["CurrentCustomerId"].ToString();
        // 替换成你的实际SharePoint站点地址和文档库名称
        var customerDocs = GetAllCustomerDocs("https://your-tenant.sharepoint.com/sites/your-site", "客户文档库", customerId);
        
        // 绑定到GridView（假设你页面上有个叫gvCustomerDocs的GridView）
        gvCustomerDocs.DataSource = customerDocs;
        gvCustomerDocs.DataBind();
    }
}

方法2：用SharePoint REST API——轻量无引用方案 #

如果不想加CSOM的NuGet包，也可以直接发HTTP请求调用REST API，适合不想动太多项目依赖的场景。

核心思路：跟着@odata.nextLink遍历所有页 #

SharePoint REST API返回的结果里会有一个@odata.nextLink（旧版本是__next），指向第二页的地址，我们循环请求直到没有这个链接就行。

用HttpClient来实现的代码示例：

using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;
using Newtonsoft.Json; // 需要安装Newtonsoft.Json NuGet包

public async Task<List<dynamic>> GetAllCustomerDocsViaRest(string spSiteUrl, string docLibraryName, string currentCustomerId)
{
    var allDocs = new List<dynamic>();
    // 初始API地址：筛选客户文档，每页500条
    string apiUrl = $"{spSiteUrl}/_api/web/lists/getbytitle('{docLibraryName}')/items?$filter=CustomerId eq '{currentCustomerId}'&$top=500";

    using (var httpClient = new HttpClient())
    {
        // 设置身份验证：比如SharePoint Online用Bearer Token，本地用Windows身份
        // 示例：Bearer Token验证
        // httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "你的身份令牌");

        HttpResponseMessage response = await httpClient.GetAsync(apiUrl);
        response.EnsureSuccessStatusCode(); // 确保请求成功

        while (!string.IsNullOrEmpty(apiUrl))
        {
            string jsonResult = await response.Content.ReadAsStringAsync();
            dynamic resultObj = JsonConvert.DeserializeObject(jsonResult);
            
            allDocs.AddRange(resultObj.value); // 加入当前页数据
            
            // 检查是否有下一页
            apiUrl = resultObj.@odata.nextLink ?? resultObj.__next;
            if (!string.IsNullOrEmpty(apiUrl))
            {
                response = await httpClient.GetAsync(apiUrl);
                response.EnsureSuccessStatusCode();
            }
        }
    }

    return allDocs;
}

几个关键注意事项 #

• 字段内部名称：代码里的CustomerId是假设的字段内部名称，不是显示名称！比如你SharePoint列表里显示“客户ID”，内部名称可能是CustomerId或者乱码格式（如果是中文字段的话）。怎么看内部名称？打开SharePoint列表的设置，点击对应字段，地址栏里Field=后面的字符串就是内部名称。
• 身份验证：不管用哪种方法，都要确保你的ASP.NET应用有访问SharePoint的权限。本地SharePoint一般用Windows身份自动继承，Online的话可能需要注册App获取权限，或者用用户名密码。
• 性能优化：如果客户的文档特别多（比如上万条），一次性拉全部可能会卡，建议后续可以改成前端分页，但先解决当前“看不到全部”的问题再说。

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