Exchange Web Services (EWS) C#：如何获取邮箱中的唯一分类列表？

嘿，别担心，这个需求是完全可以实现的！我之前在项目里刚好做过类似的功能，下面分享两种常见的实现思路，你可以根据自己使用的API环境来选择：

方法一：遍历项目去重（适合小型邮箱场景） #

如果你的邮箱里项目数量不算多，最直接的方式就是遍历所有带分类的项目，收集所有分类后再做去重处理：

List<string> allCategories = new List<string>();
// 假设你已经初始化好EWS Service对象
ItemView view = new ItemView(1000);
view.PropertySet = new PropertySet(BasePropertySet.IdOnly, ItemSchema.Categories);
FindItemsResults<Item> items;
do
{
    items = service.FindItems(WellKnownFolderName.Inbox, view);
    foreach (Item item in items)
    {
        if (item.Categories != null && item.Categories.Count > 0)
        {
            allCategories.AddRange(item.Categories);
        }
    }
    view.Offset += items.Items.Count;
} while (items.MoreAvailable);

// 去重得到唯一分类列表
var uniqueCategories = allCategories.Distinct().ToList();

这种方法逻辑简单，但如果邮箱里有几万甚至几十万条项目，遍历的效率会比较低，适合小型邮箱或者测试场景。

方法二：利用系统扩展属性直接读取（高效方案） #

如果是Exchange Server 2013及以上版本，或者使用Office 365的Graph API，邮箱本身会存储所有已使用过的分类集合，不用遍历项目就能直接获取：

针对EWS Managed API的高效查询 #

// 指向存储邮箱分类的系统扩展属性
ExtendedPropertyDefinition categoryProp = new ExtendedPropertyDefinition(DefaultExtendedPropertySet.Common, 0x3600, MapiPropertyType.StringArray);
Folder inbox = Folder.Bind(service, WellKnownFolderName.Inbox);
var props = inbox.GetProperties(new PropertySet(categoryProp));
if (props.ContainsKey(categoryProp))
{
    var allCategories = props[categoryProp] as IEnumerable<string>;
    var uniqueCategories = allCategories.Distinct().ToList();
}

这个属性里直接存着邮箱中所有已使用的分类，读取后简单去重就能得到唯一列表，效率比遍历高很多。

针对Microsoft Graph API的方案 #

如果你用的是Graph API，那就更方便了，直接调用接口就能拿到所有主分类：

GET https://graph.microsoft.com/v1.0/me/outlook/masterCategories

返回的结果就是邮箱里所有的唯一分类列表，不用自己做任何去重处理。

小提醒：Exchange Server 2010及更早版本可能不支持第二种高效方法，只能用第一种遍历去重的方式。

希望这些方法能帮到你，如果有具体的API版本或者开发语言的细节，还可以再调整优化！

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