如何使用Microsoft Graph及.NET SDK筛选SharePoint列表项？

看起来你在使用.NET SDK通过Graph API筛选SharePoint列表时遇到了两个典型问题，我来帮你逐一分析并给出解决方案：

问题1：添加.Filter("fields/Archived eq false")后未生效，返回所有项 #

这种情况最常见的原因是你使用了字段的显示名称而非内部名称。SharePoint的自定义字段存在显示名和内部名的区别，Graph API筛选时必须使用内部名称才能精准匹配。

解决步骤： #

1. 获取字段的内部名称：
   打开SharePoint列表的设置页面，点击你要筛选的Archived字段，查看浏览器地址栏的URL，找到类似Field=Archived的部分（如果是自定义字段，内部名可能带有特殊前缀，比如_x0041_rchived），这就是你需要用的正确字段名。
2. 修正Filter语法：
   将Filter中的字段名替换为内部名称，示例代码如下：

   var filteredItems = await graphClient.Sites["你的站点ID"].Lists["你的列表ID"].Items
       .Request()
       .Expand("fields")
       .Filter("fields/你的内部字段名 eq false")
       .GetAsync();
   

3. 额外检查点：
   • 确保布尔值是小写的false，Graph API对大小写敏感；
   • 确认该字段类型支持筛选（布尔字段默认支持，多行文本等部分类型不支持筛选）。

问题2：使用.Expand("fields($filter=Archived eq false)")报错 #

这种写法本身就不符合Graph API的语法规则——fields是列表项的属性集合，并非可筛选的关联资源（比如用户的邮件、日历事件这类多值集合），因此不能在Expand中对fields添加$filter参数。Expand内的筛选仅适用于展开多值关联资源的场景，而列表项的字段是单值属性，直接在列表项请求上添加Filter即可。

额外验证技巧 #

你可以先在Graph Explorer中测试对应的REST请求，确认筛选逻辑是否正常：

GET https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items?$expand=fields&$filter=fields/你的内部字段名 eq false

如果Graph Explorer能正确返回筛选后的结果，那.NET SDK的写法只要和请求对应就会生效；如果Graph Explorer也不行，那就要检查字段权限、内部名称或者字段是否支持筛选了。

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