EWS按Required Attendees搜索约会遇问题：代码无法运行，求实现方法

我明白你在尝试通过必填参会人搜索约会时遇到了问题，这在Exchange或Outlook相关开发里是个很常见的需求，咱们一步步来解决它。下面我会针对两种主流技术栈给出可行的实现方案，你可以根据自己的场景选择：

方案一：使用EWS Managed API（适用于Exchange Server环境） #

如果你的项目基于Exchange Web Services，大概率是之前的过滤条件没正确关联必填参会人属性。下面是完整的实现代码，包含正确的筛选逻辑：

using Microsoft.Exchange.WebServices.Data;

// 初始化EWS服务实例
ExchangeService ewsService = new ExchangeService(ExchangeVersion.Exchange2016);
// 这里如果是OAuth认证，替换为对应的Token方式即可
ewsService.Credentials = new WebCredentials("your-account@domain.com", "your-password");
ewsService.AutodiscoverUrl("your-account@domain.com");

// 创建筛选器：精准匹配必填参会人邮箱
SearchFilter.ExactMatchFilter attendeeFilter = new SearchFilter.ExactMatchFilter(
    ItemSchema.RequiredAttendees, 
    "target-attendee@domain.com");

// 设置返回的属性和结果数量
ItemView calendarView = new ItemView(100);
calendarView.PropertySet = new PropertySet(
    BasePropertySet.FirstClassProperties,
    AppointmentSchema.Subject,
    AppointmentSchema.Start,
    AppointmentSchema.RequiredAttendees);

// 执行日历搜索
FindItemsResults<Item> searchResults = ewsService.FindItems(
    WellKnownFolderName.Calendar, 
    attendeeFilter, 
    calendarView);

// 遍历处理结果
foreach (Item item in searchResults.Items)
{
    if (item is Appointment targetAppointment)
    {
        Console.WriteLine($"约会主题: {targetAppointment.Subject}");
        Console.WriteLine("必填参会人列表:");
        foreach (Attendee attendee in targetAppointment.RequiredAttendees)
        {
            Console.WriteLine($"- {attendee.Name} <{attendee.Address}>");
        }
        Console.WriteLine("------------------------");
    }
}

关键注意点： #

• 确保EWS Managed API版本和你的Exchange服务器版本兼容
• 如果需要模糊匹配（比如只搜名字），可以把ExactMatchFilter换成ContainsFilter，并指定ContainmentMode.Substring
• 生产环境建议使用OAuth认证替代账号密码，避免安全风险

方案二：使用Microsoft Graph API（适用于Office 365/Outlook.com环境） #

现在更多开发者会选择Graph API，它的查询逻辑更直观，通过$filter表达式就能精准筛选必填参会人：

using Microsoft.Graph;
using Azure.Identity;

// 初始化Graph客户端（这里用客户端凭证模式，委托模式可替换为InteractiveBrowserCredential）
var graphScopes = new[] { "Calendars.Read" };
var clientCredential = new ClientSecretCredential(
    "your-tenant-id", 
    "your-client-id", 
    "your-client-secret");
var graphClient = new GraphServiceClient(clientCredential, graphScopes);

// 搜索指定邮箱作为必填参会人的约会
var targetEvents = await graphClient.Me.Events
    .Request()
    .Filter($"attendees/any(a: a/type eq 'required' and a/emailAddress/address eq 'target-attendee@domain.com')")
    .Select("subject, start, attendees")
    .GetAsync();

// 处理搜索结果
foreach (var calendarEvent in targetEvents)
{
    Console.WriteLine($"约会主题: {calendarEvent.Subject}");
    Console.WriteLine("必填参会人:");
    foreach (var attendee in calendarEvent.Attendees.Where(a => a.Type == AttendeeType.Required))
    {
        Console.WriteLine($"- {attendee.EmailAddress.Name} <{attendee.EmailAddress.Address}>");
    }
    Console.WriteLine("------------------------");
}

关键注意点： #

• 要在Azure AD中正确配置应用权限（需要Calendars.Read或Calendars.ReadWrite权限）
• 如果是针对其他用户的日历搜索，把Me换成Users["user-id"]即可
• $filter里的any表达式是核心，确保同时筛选了参会人类型为required和匹配的邮箱地址

常见错误排查 #

如果还是不行，可以检查这几点：

• 邮箱地址是否拼写正确，注意大小写不影响匹配，但格式要完整（比如xxx@domain.com）
• 是否有足够的权限读取目标日历
• 如果你用的是其他技术栈（比如PowerShell、原生REST），可以告诉我具体场景，我再调整方案

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