SharePoint Online列表超视图阈值查询报错解决方案咨询

你遇到的这个错误是SharePoint Online的列表视图阈值限制导致的——默认情况下，单次查询不能返回超过2000条列表项，避免影响系统性能。要遍历超过2000条的列表，我们需要用分页查询的方式，每次获取一小部分数据，循环直到处理完所有条目。

核心思路：使用ListItemCollectionPosition实现分页 #

SharePoint Client Object Model提供了ListItemCollectionPosition类，它可以记录当前分页的位置，让我们每次查询都从上一次结束的地方继续获取数据。具体步骤是：

• 初始化CAML查询，设置RowLimit（建议每次取500条，不要超过2000）
• 循环执行查询，每次把上一次的ListItemCollectionPosition赋值给新的查询
• 直到ListItemCollectionPosition为null，说明所有数据都处理完毕

修改后的代码实现 #

下面是针对你的需求修改后的完整代码，重点优化了分页遍历逻辑，同时调整了创建列表项的方法使其更健壮：

using System;
using Microsoft.SharePoint.Client;
using System.Collections.Generic;
using System.Configuration;
using System.Linq;
using System.Security;
using System.Text;
using System.Threading.Tasks;

namespace IndicadoresCartera
{
    public class SPQuery
    {
        public ClientContext clientContext;
        public Web site;
        public ListItemCreationInformation itemCreateInfo;
        static SPQuery queryService = new SPQuery();

        public SPQuery()
        {
            string url = ConfigurationManager.AppSettings["url"];
            string user = ConfigurationManager.AppSettings["user"];
            string password = ConfigurationManager.AppSettings["password"];
            SecureString securePassword = new SecureString();
            foreach (char c in password.ToCharArray())
                securePassword.AppendChar(c);
            clientContext = new ClientContext(url);
            clientContext.Credentials = new SharePointOnlineCredentials(user, securePassword);
            site = clientContext.Web;
            itemCreateInfo = new ListItemCreationInformation();
        }

        // 支持分页的列表查询方法
        public ListItemCollection QueryListWithPaging(string listTitle, string viewXml, ref ListItemCollectionPosition position)
        {
            List targetList = clientContext.Web.Lists.GetByTitle(listTitle);
            CamlQuery query = new CamlQuery();
            query.ViewXml = viewXml;
            query.ListItemCollectionPosition = position; // 设置当前分页位置

            ListItemCollection items = targetList.GetItems(query);
            clientContext.Load(items);
            clientContext.ExecuteQuery();

            position = items.ListItemCollectionPosition; // 更新分页位置，供下一次查询使用
            return items;
        }

        // 重构后的创建列表项方法，更易维护
        public bool CreateItem(string listTitle, Dictionary<string, object> fieldValues)
        {
            try
            {
                List targetList = site.Lists.GetByTitle(listTitle);
                ListItem newItem = targetList.AddItem(itemCreateInfo);

                // 批量设置字段值
                foreach (var kvp in fieldValues)
                {
                    newItem[kvp.Key] = kvp.Value;
                }

                newItem.Update();
                clientContext.ExecuteQuery();
                return true;
            }
            catch (Exception e)
            {
                Console.WriteLine("Error creating item: " + e.Message);
                return false;
            }
        }

        public void GetClientes()
        {
            ListItemCollectionPosition pagingPosition = null;
            const int batchSize = 500; // 每次获取500条，可根据实际情况调整（不超过2000）

            // 构造包含RowLimit的CAML视图，只加载需要的字段减少传输量
            string viewXml = $@"
                <View>
                    <ViewFields>
                        <FieldRef Name='ID' />
                        <FieldRef Name='Title' />
                        <FieldRef Name='code' />
                        <FieldRef Name='name' />
                        <FieldRef Name='FechaSolicitud' />
                        <FieldRef Name='FechaAsignacionCodigo' />
                    </ViewFields>
                    <RowLimit>{batchSize}</RowLimit>
                </View>";

            do
            {
                // 分页获取clients列表数据
                ListItemCollection clientItems = QueryListWithPaging("clients", viewXml, ref pagingPosition);

                foreach (var cl in clientItems.ToList())
                {
                    // 筛选Title、code、name不为空的条目
                    if (cl["Title"] != null && cl["code"] != null && cl["name"] != null)
                    {
                        // 准备要插入到indicators的字段值
                        var fieldValues = new Dictionary<string, object>
                        {
                            {"Proceso", "Cliente"},
                            {"IdProceso", cl.Id},
                            {"Responsable", "Cartera"},
                            {"Rol", "Cartera"},
                            {"Inicio", cl["FechaSolicitud"]},
                            {"Fin", cl["FechaAsignacionCodigo"]},
                            {"EstadoFinal", "Cliente Creado"}
                        };

                        queryService.CreateItem("indicators", fieldValues);
                    }
                }

                Console.WriteLine($"Processed {clientItems.Count} items, continuing...");

            } while (pagingPosition != null); // 直到分页位置为null，说明所有数据处理完毕

            Console.WriteLine("All client items processed successfully!");
        }
    }
}

关键优化点说明 #

1. 分页查询逻辑：通过ListItemCollectionPosition实现无缝分页，彻底规避视图阈值限制。
2. 字段按需加载：在CAML的ViewFields中只指定需要的字段，减少数据传输量，提升查询效率。
3. 创建项方法重构：使用字典传递字段值，代码更清晰，也避免了原方法中参数使用的逻辑问题。
4. 批量大小控制：设置batchSize为500，平衡查询效率和系统负载，你也可以根据实际环境调整这个数值（上限2000）。

额外注意事项 #

• 确保你的账号拥有两个列表（clients和indicators）的读写权限。
• 注意日期类型字段（如FechaSolicitud）的类型匹配，避免类型转换异常。
• 如果网络不稳定，可以考虑给查询添加重试逻辑，提升代码的健壮性。

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