如何在Microsoft Graph筛选器中正确编码SharePoint列表名称的特殊字符？

这个问题的核心是混淆了URL编码和OData表达式的字符串转义规则——Graph的filter参数是OData表达式，不是URL路径段，所以不需要用UrlEncode处理，只需要遵循OData的字符串转义规范即可。

正确的处理步骤 #

• 仅转义单引号：在OData的字符串字面量中，单引号'是特殊字符，需要用两个单引号''来转义；其他特殊字符（比如:、£、&等）可以直接保留，不需要编码。
• 不要使用URL编码：GraphServiceClient会自动处理查询参数的URL编码，手动编码反而会导致Graph解码后破坏OData表达式的语法。

修正后的代码示例 #

var name = "lis !\"£$%^&*()_+-=[]{};':@#~/.,?><`¬";
// 仅转义字符串中的单引号
var escapedDisplayName = name.Replace("'", "''");
// 直接构造OData筛选器，无需URL编码
existingListRequest.QueryOptions.Add(new QueryOption("filter", $"displayName eq '{escapedDisplayName}'"));

为什么之前的方法失败？ #

• 你尝试的UrlEncode会把特殊字符转成%xx格式，但Graph在解析filter参数时会自动做URL解码，导致这些编码被还原成原字符，而未转义的单引号会直接破坏OData表达式的语法，抛出"The expression ... is not valid"错误。
• 两次编码或替换%为%25会导致字符被双重编码，Graph解码后得到的是%xx而非原字符，自然无法匹配到列表名称。

额外验证 #

如果你的列表名称确实存在，用这种方法构造的筛选器应该能精准匹配。如果仍有问题，可以通过Graph Explorer测试筛选器表达式，确认转义后的字符串是否正确匹配列表的displayName属性。

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