EWS使用查询字符串调用FindItems仅返回250条结果的解决问询

问题原因 #

当使用EWS的FindItems方法结合AQS查询字符串（如from: administrator@example.com）时，Exchange搜索索引默认会限制返回最多250条结果，且MoreAvailable属性会被设为false，TotalCount也会被截断为250。而无筛选的调用是直接枚举文件夹内容，不受此限制。

解决方案 #

方案一：使用SearchFilter替代AQS查询字符串 #

通过SearchFilter构建筛选条件，可绕过AQS的250条结果限制，配合分页逻辑正常获取全部匹配邮件。

示例代码：

// 构建发件人匹配筛选器
var searchFilter = new SearchFilter.IsEqualTo(
    EmailMessageSchema.From, 
    new EmailAddress("administrator@example.com")
);

// 初始化分页视图，每页最多1000条（EWS单页上限）
var view = new ItemView(1000);
ItemCollection<Item> results;

do
{
    results = service.FindItems(WellKnownFolderName.Inbox, searchFilter, view);
    
    // 处理当前页的邮件
    foreach (var item in results.Items)
    {
        // 执行业务逻辑，如需完整属性可调用LoadPropertiesForItems
        // service.LoadPropertiesForItems(new List<Item> { item }, PropertySet.FirstClassProperties);
    }

    // 更新分页偏移量，准备获取下一页
    view.Offset += results.Items.Count;
} while (view.Offset < results.TotalCount);

方案二：调整AQS查询参数（仅部分Exchange版本支持） #

如果必须使用AQS查询字符串，可尝试在查询末尾添加ResultSize:Unlimited参数，突破默认的250条限制。

示例代码：

var query = "from: administrator@example.com ResultSize:Unlimited";
var view = new ItemView(1000);
ItemCollection<Item> results;

do
{
    results = service.FindItems(WellKnownFolderName.Inbox, query, view);
    
    // 处理当前页邮件
    foreach (var item in results.Items)
    {
        // 业务逻辑
    }

    view.Offset += results.Items.Count;
} while (results.MoreAvailable);

关键注意事项 #

• 始终将ItemView.PageSize设置为1000（EWS允许的单页最大数量），减少分页次数，提升效率
• 使用SearchFilter时，TotalCount会返回准确的匹配总数，可通过偏移量循环直到达到总数
• ResultSize:Unlimited参数的有效性依赖Exchange服务器版本，若无效请优先使用方案一
• 严格遵循分页逻辑，避免一次性请求大量数据，符合EWS限流规则

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