VB Caml Query异常：SharePoint列表转表格无法按条件筛选

核心问题：CAML 查询格式错误 #

你的CAML查询存在两个关键错误，导致SharePoint直接忽略筛选条件，返回全列表：

• FieldRef标签写法错误：你把Name属性写在了标签内容里，正确写法是将Name作为标签属性。
• ViewXml缺少外层<View>标签：CamlQuery要求完整的视图结构，仅<Query>标签会被系统忽略。

修正后的基础查询代码 #

以下是针对Email字段筛选的修正后代码：

Dim camlQuery As CamlQuery = New CamlQuery()
' 补充外层<View>标签，修正FieldRef的属性写法
camlQuery.ViewXml = "<View><Query><Where><Eq><FieldRef Name='Email'/><Value Type='Text'>my@mail.com</Value></Eq></Where></Query></View>"
Dim collListItem As ListItemCollection = oList.GetItems(camlQuery)

实现日期筛选功能 #

要按指定日期筛选外出人员，假设你的日期字段内部名称为OOFDate（需替换为实际字段内部名称），需注意：

• 日期类型的Value必须指定Type='DateTime'
• 日期格式需使用ISO8601标准（yyyy-MM-ddTHH:mm:ssZ），若只需匹配日期部分，可添加IncludeTimeValue='FALSE'忽略时间

示例代码（假设日期选择器选中的日期为selectedDate）：

' 将选中日期转换为ISO8601格式
Dim isoDate As String = selectedDate.ToString("yyyy-MM-ddTHH:mm:ssZ")
Dim camlQuery As CamlQuery = New CamlQuery()
camlQuery.ViewXml = $"<View><Query><Where><Eq><FieldRef Name='OOFDate'/><Value Type='DateTime' IncludeTimeValue='FALSE'>{isoDate}</Value></Eq></Where></Query></View>"

解决“value does not fall within the expected range”错误 #

该错误通常是因为你使用的字段显示名称与SharePoint内部存储的内部名称不匹配。获取字段内部名称的方法：

• 打开SharePoint列表设置，找到对应字段并进入编辑页面
• 查看浏览器地址栏，URL中Field=后面的字符串即为字段内部名称（自定义字段可能是field_xxx格式）

额外注意事项 #

• 字段类型必须匹配：若Email字段是Person or Group类型，不能用Type='Text'，需改用Type='User'，查询结构调整为：

  <Eq><FieldRef Name='Email'/><Value Type='User'>my@mail.com</Value></Eq>
  

• 测试查询时，可先在SharePoint列表的“创建视图”中手动配置筛选条件，再查看视图的CAML代码，对比验证自己的查询格式是否正确。

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