使用Microsoft Graph API V1.0匹配部门名称时遇问题

这个问题我之前也碰到过！核心原因是&既是OData筛选语法里的逻辑运算符，也是URL的特殊分隔符，直接拼接字符串或者用C#的\&转义根本没用——C#的转义只在本地字符串生效，传到API那边会被解析错误，导致Filter语句被截断，自然报Invalid filter clause。

给你两个靠谱的解决方案，优先用第一个：

方案一：使用参数化查询（推荐，安全又省心） #

Graph SDK支持参数绑定，把要筛选的值作为独立参数传递，SDK会自动处理所有特殊字符的编码和转义，完全不用你手动折腾。代码示例：

string departmentName = "Admin & IT";
// 用@参数占位符代替直接拼接字符串
var filterExpression = $"department eq @deptName";

var departmentPeoples = await graphServiceClient.Users
    .Request()
    .Filter(filterExpression)
    // 添加参数绑定，把实际值传进去
    .AddQueryOption("@deptName", departmentName)
    .Select(u => new { u.DisplayName, u.MobilePhone, u.BusinessPhones, u.UserPrincipalName })
    .GetAsync();

这种方式不仅能解决&的问题，还能避免潜在的OData注入风险，绝对是最佳实践。

方案二：手动处理URL编码（不推荐，容易踩坑） #

如果你非要手动拼接Filter字符串，得把整个部门名称做URL编码，确保&不会被当成URL参数分隔符。代码示例：

string departmentName = "Admin & IT";
// 对部门名称进行URL编码
string encodedDeptName = Uri.EscapeDataString(departmentName);

var departmentPeoples = await graphServiceClient.Users
    .Request()
    .Filter($"department eq '{encodedDeptName}'")
    .Select(u => new { u.DisplayName, u.MobilePhone, u.BusinessPhones, u.UserPrincipalName })
    .GetAsync();

不过这种方式要额外注意：如果部门名称里有单引号，你还得手动把单引号转成双单引号（OData字符串里的单引号转义规则），所以还是参数化查询更省心。

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