使用GraphServiceClient PageIterator获取AzureAD组成员时遇报错

问题原因 #

你遇到的错误核心是泛型类型不匹配：

• Groups[groupId].Members.GetAsync()返回的是DirectoryObjectCollectionResponse，其中包含的是DirectoryObject类型的集合（组成员可以是用户、组、设备等多种目录对象）。
• 你直接将PageIterator的泛型参数指定为<User, DirectoryObjectCollectionResponse>，但DirectoryObjectCollectionResponse中并没有User类型的集合属性，导致PageIterator无法识别正确的集合字段，从而抛出错误。

解决方案 #

提供两种可行的修复方式，根据你的需求选择：

方案1：仅获取组成员中的用户（推荐） #

使用OfUser()方法直接过滤出组成员中的用户，此时返回的是UserCollectionResponse，泛型类型完全匹配，无需额外类型转换：

List<User> users = new();
var result = await graphClient.Groups[groupId].Members.OfUser.GetAsync(requestConfiguration =>
{
    requestConfiguration.QueryParameters.Top = 2;
    // 强制分页的测试代码，正式版本可移除
});

var pageIterator = PageIterator<User, UserCollectionResponse>
    .CreatePageIterator(graphClient, result,
        (user) =>
        {
            users.Add(user);
            return true;
        });

await pageIterator.IterateAsync();

方案2：处理所有类型的组成员并筛选用户 #

如果需要处理所有类型的组成员（比如同时获取用户和组），可以保留Members.GetAsync()，但需要将PageIterator的泛型参数改为<DirectoryObject, DirectoryObjectCollectionResponse>，并在回调中判断类型后转换为User：

List<User> users = new();
var result = await graphClient.Groups[groupId].Members.GetAsync(requestConfiguration =>
{
    requestConfiguration.QueryParameters.Top = 2;
    // 可选：提前过滤只返回用户，减少后续类型判断
    requestConfiguration.QueryParameters.Filter = "odata.type eq '#microsoft.graph.user'";
});

var pageIterator = PageIterator<DirectoryObject, DirectoryObjectCollectionResponse>
    .CreatePageIterator(graphClient, result,
        (directoryObject) =>
        {
            // 判断当前目录对象是否为用户类型
            if (directoryObject is User user)
            {
                users.Add(user);
            }
            return true;
        },
        // 可选：显式指定集合属性名称为"value"（部分场景下需要）
        (request) => request,
        "value");

await pageIterator.IterateAsync();

关键说明 #

• DirectoryObject是Azure AD中所有目录对象的基类，包括User、Group、Device等，直接用User作为PageIterator的泛型参数会导致类型不匹配。
• 使用OfUser()方法是最简洁的方式，它会自动添加筛选条件并返回User类型的集合，避免类型转换的麻烦。

内容的提问来源于stack exchange，提问作者Raymond A.