Windows环境下获取组内用户的“名 姓”格式用户名

问题背景 #

需要获取Windows开始菜单显示的用户全名（如“John Doe”），而非登录用的字符串ID。直接用正则拆分用户名通用性差，尝试System.DirectoryServices.AccountManagement.UserPrincipal.Current.DisplayName时，因当前Principal类型为GroupPrincipal，抛出“无法将GroupPrincipal类型转换为UserPrincipal类型”异常。

解决方案 #

方法1：通过SID精准查询用户主体（推荐）

先捕获类型转换异常，改用当前用户的SID来查找UserPrincipal，避免类型不匹配问题：

using System.DirectoryServices.AccountManagement;
using System.Security.Principal;
using System;

public static string GetCurrentUserDisplayName()
{
    try
    {
        // 常规场景：直接获取UserPrincipal
        using (var userPrincipal = UserPrincipal.Current)
        {
            return !string.IsNullOrEmpty(userPrincipal.DisplayName) 
                ? userPrincipal.DisplayName 
                : GetFallbackUserName();
        }
    }
    catch (InvalidCastException)
    {
        // 处理GroupPrincipal转换异常：通过SID定位用户
        var currentIdentity = WindowsIdentity.GetCurrent();
        using (var context = new PrincipalContext(ContextType.Domain))
        {
            var userPrincipal = UserPrincipal.FindByIdentity(context, currentIdentity.User.Value);
            if (userPrincipal != null && !string.IsNullOrEmpty(userPrincipal.DisplayName))
            {
                return userPrincipal.DisplayName;
            }
        }
        // 域场景失败则尝试本地上下文
        using (var localContext = new PrincipalContext(ContextType.Machine))
        {
            var localUser = UserPrincipal.FindByIdentity(localContext, currentIdentity.User.Value);
            return localUser?.DisplayName ?? GetFallbackUserName();
        }
    }
}

private static string GetFallbackUserName()
{
    // 兜底：返回登录名（非显示名，仅作为备选）
    return WindowsIdentity.GetCurrent().Name.Split('\\').Last();
}

说明：

• WindowsIdentity.GetCurrent().User.Value获取当前用户的唯一SID，通过SID查询能精准定位到用户主体，不受当前线程Principal类型影响。
• 同时兼容域用户和本地用户场景，依次尝试域上下文和本地上下文查询。

方法2：通过WMI查询用户全名

利用Win32_UserAccount类的FullName字段直接获取显示名称，无需处理AccountManagement的类型问题：

using System.Management;
using System;

public static string GetUserDisplayNameViaWMI()
{
    try
    {
        var userName = Environment.UserName;
        using (var searcher = new ManagementObjectSearcher(
            $"SELECT FullName FROM Win32_UserAccount WHERE Name = '{userName}'"))
        {
            foreach (var obj in searcher.Get())
            {
                return obj["FullName"]?.ToString() ?? GetFallbackUserName();
            }
        }
    }
    catch (ManagementException)
    {
        // 处理WMI权限或查询失败
        return GetFallbackUserName();
    }
    return GetFallbackUserName();
}

说明：

• Win32_UserAccount的FullName字段对应开始菜单显示的用户全名。
• 需注意WMI查询可能受权限限制，部分环境下无法访问。

关键注意点 #

• 避免依赖正则拆分用户名：不同用户的登录名格式差异大（如域用户DOMAIN\user、本地用户USER），正则无法覆盖所有场景。
• UserPrincipal.Current的局限：仅当当前线程的Principal为UserPrincipal时有效，特殊场景（如服务以组身份运行）会触发类型转换异常，需通过SID查询做兼容。

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