值不在预期范围内. SharePoint Join SPQuery

如果你在开发 SharePoint 解决方案并且要使用 SharePoint Join SPQuery，你可能会遇到“值不在预期范围内”的错误。该错误通常发生在以下情况下：

• 你使用 Join SPQuery 语句并且尝试连接两个以上的列表。
• 你的 Join SPQuery 语句中包含了一个或多个错误的字段名或列名。

为了解决这个问题，你应该按照以下步骤进行处理：

1. 确认你的 Join SPQuery 语句正确无误。这包括正确的列表名称、正确的字段名和列名。如果你不确定，可以使用 U2U CAML Query Builder 或者 SharePoint Designer 来验证你的语句是否正确无误。

2. 确认你的查询中使用到的列或字段名都在正确的列表中。如果你使用的是别名，请确保它们在查询中正确匹配。

3. 如果你的 Join SPQuery 语句中涉及到多个列表，请使用该列表的 ID 而不是名称来引用列或字段。

4. 如果你的 Join SPQuery 语句中包含了多个字段，你可以尝试使用 U2U CAML Query Builder 或 SharePoint Designer 来验证你的语句是否正确无误。

下面是一个演示如何使用 Join SPQuery 的示例代码：

SPQuery query = new SPQuery();
query.Join = "<Join Type='INNER' ListAlias='test1'>" +
             "<Eq>" +
             "<FieldRef Name='ID' RefType='Id' />" +
             "<FieldRef List='test1' Name='ID' />" +
             "</Eq>" +
             "</Join>";
query.ViewFields = "<FieldRef Name='Title' />" +
                  "<FieldRef List='test1' Name='Title' />";
query.ViewFieldsOnly = true;
SPListItemCollection items = list.GetItems(query);

该 Join SPQuery 语句将返回包含与当前列表相关的 test1 列表的项的标题字段和 test1 表中的标题字段的列表项集合。

在本例中，值不在预期范围内的错误通常在以下情况下发生：

1. test1 列表中不存在名称为标题或 ID 的列。
2. 如果语句中的 Join Type 设置为错误的值，将会导致错误。

考虑到这些因素，你可以根据需要进行调整。通过正确的使用 Join SPQuery 语句，你可以更好地创建 SharePoint 解决方案，从而实现更高效和强大的应用程序。