如何用System.DirectoryServices.AccountManagement返回含Title等属性的AD用户IEnumerable

我之前也踩过这个坑！PrincipalSearcher为了查询性能，默认返回的UserPrincipal对象只会加载最基础的属性集合（比如SamAccountName、DisplayName），像Title、EmailAddress这类属于AD的扩展属性，不管是FindAll()还是FindOne()都不会自动加载——哪怕FindOne()能拿到更多属性，也只是隐式加载了部分，不是全部。

而UserPrincipal.GetUnderlyingObject()正是解决这个问题的关键，它能帮你拿到底层的DirectoryEntry对象，通过这个对象我们可以手动加载并获取需要的AD属性。下面是具体的实现步骤和代码示例：

核心思路 #

1. 用PrincipalSearcher执行查询，拿到UserPrincipal结果
2. 调用GetUnderlyingObject()转换为DirectoryEntry
3. 调用DirectoryEntry.RefreshCache()显式指定要加载的LDAP属性（注意用AD原生的属性名，比如title对应Title，mail对应EmailAddress）
4. 从DirectoryEntry.Properties中读取属性值

完整代码示例 #

using System.DirectoryServices;
using System.DirectoryServices.AccountManagement;

// 初始化域上下文
using (var domainContext = new PrincipalContext(ContextType.Domain))
{
    // 创建UserPrincipal作为查询筛选器（这里可以加筛选条件，比如user.GivenName = "John"）
    using (var userFilter = new UserPrincipal(domainContext))
    using (var searcher = new PrincipalSearcher(userFilter))
    {
        foreach (var searchResult in searcher.FindAll())
        {
            if (searchResult is UserPrincipal userPrincipal)
            {
                // 获取底层的DirectoryEntry对象
                var adUserEntry = userPrincipal.GetUnderlyingObject() as DirectoryEntry;
                if (adUserEntry == null) continue;

                // 显式加载需要的属性：这里传入AD的LDAP属性名数组
                adUserEntry.RefreshCache(new[] { "title", "mail", "department", "telephoneNumber" });

                // 读取属性值，注意处理null情况
                var userTitle = adUserEntry.Properties["title"]?.Value?.ToString();
                var userEmail = adUserEntry.Properties["mail"]?.Value?.ToString();
                var userDepartment = adUserEntry.Properties["department"]?.Value?.ToString();

                // 基础属性可以直接从UserPrincipal获取
                var userName = userPrincipal.DisplayName;
                var samAccountName = userPrincipal.SamAccountName;

                // 后续逻辑：比如存入集合
                // yourCollection.Add(new { Name = userName, Title = userTitle, Email = userEmail });
            }
        }
    }
}

关键注意事项 #

• LDAP属性名对应关系：UserPrincipal的属性名和AD原生LDAP属性名不一定一致，比如EmailAddress对应mail，Title对应title，Department对应department，如果不确定可以通过AD属性编辑器查看。
• 必须调用RefreshCache：DirectoryEntry默认也不会加载所有属性，必须显式指定要加载的属性列表，否则Properties里可能拿不到对应的值。
• 资源释放：所有实现了IDisposable的对象（PrincipalContext、UserPrincipal、PrincipalSearcher、DirectoryEntry）都要用using包裹，避免资源泄漏。
• 性能优化：如果查询的用户数量很大，尽量只加载你需要的属性，不要一次性加载所有属性，避免影响查询速度。

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