UserInformation 类

定义

表示有关用户的信息,例如姓名和用户头像。

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅“备注”。

public ref class UserInformation abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.System.UserProfile.UserProfileContract, 65536)]
class UserInformation final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.System.UserProfile.UserProfileContract, 65536)]
/// [Windows.Foundation.Metadata.Deprecated("Use User instead of UserInformation. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 131072, "Windows.System.UserProfile.UserProfileContract")]
class UserInformation final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.System.UserProfile.UserProfileContract), 65536)]
public static class UserInformation
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.System.UserProfile.UserProfileContract), 65536)]
[Windows.Foundation.Metadata.Deprecated("Use User instead of UserInformation. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 131072, "Windows.System.UserProfile.UserProfileContract")]
public static class UserInformation
Public Class UserInformation
继承
Object Platform::Object IInspectable UserInformation
属性

Windows 要求

设备系列
Windows Desktop Extension SDK (在 10.0.10240.0 中引入)
Windows Mobile Extension SDK (在 10.0.10240.0 中引入)
API contract
Windows.System.UserProfile.UserProfileContract (在 v1.0 中引入)

示例

function getUserInfo() {
    image = Windows.System.UserProfile.UserInformation.getAccountPicture(Windows.System.UserProfile.AccountPictureKind.smallImage);
    imageURL = URL.createObjectURL(image, false);
}    

注解

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。

Windows 10在 Windows 10 上运行时,使用 UserInformation 类为 Windows 8 编译的应用不再返回用户信息。 这是因为在Windows 10中,应用在未经明确用户同意的情况下无法访问用户信息,这与 Windows 8 中默认授予此权限的情况不同。

如果你有使用 UserInformation 类的 Windows 8 应用,则应将应用迁移到通用 Windows 平台 (UWP) 并改为访问 User 类。 通用 Windows 平台 (访问用户信息的 UWP) 应用现在应声明新功能 uap:userAccountInformation,并调用新 API Windows.System.User.FindAllAsyncUser.GetPropertiesAsync 以获取数据。

当用户安装应用时,系统会提示他们允许访问其用户信息。 如果用户允许应用访问信息,则应用将显示在Windows 10设置 UI 的“隐私”页中列出, (“设置”>隐私>帐户信息) 。 这使Windows 10用户能够基于每个应用访问用户信息。

还可以通过部署组策略更改来启用对用户信息的访问,而无需进行其他代码修改,这对业务和企业客户特别有用。 若要允许访问Windows 10上的用户信息,请启用以下组策略设置并将其设置为“Always On”:计算机配置 > 管理模板 > 系统>用户配置文件 > 用户管理与应用共享用户名、用户头像和域信息 (而不是桌面应用) 。 有关详细信息,请下载组策略 Windows 和 Windows Server 的设置参考

Windows 8 若要在用户头像模式下启动并在没有其他提示的情况下设置用户图片,应用必须通过在应用清单的 “扩展 ”部分中包括以下内容来注册为用户头像提供程序。

属性

AccountPictureChangeEnabled

确定是否可以更改用户的用户头像。

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的“备注”。

NameAccessAllowed

允许你查看是否允许你的应用访问用户的信息。

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的“备注”。

方法

GetAccountPicture(AccountPictureKind)

获取用户的用户头像。

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的“备注”。

GetDisplayNameAsync()

获取用户帐户的显示名称。

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的“备注”。

GetDomainNameAsync()

获取用户的域名。

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的“备注”。

GetFirstNameAsync()

获取用户的名字。

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的“备注”。

GetLastNameAsync()

获取用户的姓氏。

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的“备注”。

GetPrincipalNameAsync()

获取用户的主体名称。 此名称是通常 (用户地址的用户主体名称,但并非总是如此。)

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的“备注”。

GetSessionInitiationProtocolUriAsync()

获取用户的会话初始协议的统一资源标识符 (URI) 。

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的“备注”。

SetAccountPictureAsync(IStorageFile)

使用 IStorageFile 对象设置用户帐户的图片。

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的“备注”。

SetAccountPictureFromStreamAsync(IRandomAccessStream)

使用 IRandomAccessStream 对象设置用户帐户的图片。

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的“备注”。

SetAccountPicturesAsync(IStorageFile, IStorageFile, IStorageFile)

使用 IStorageFile 对象设置用户帐户的图片。 支持添加小图像、大图像和视频。

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的“备注”。

SetAccountPicturesFromStreamsAsync(IRandomAccessStream, IRandomAccessStream, IRandomAccessStream)

使用 IRandomAccessStream 对象设置用户帐户的图片。 支持添加小图像、大图像和视频。

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的“备注”。

事件

AccountPictureChanged

当用户的图像或名称更改时发生。

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的“备注”。

适用于

另请参阅