UserInformation Clase

Definición

Espacio de nombres:

Windows.System.UserProfile

Representa información sobre el usuario, como el nombre y la imagen de la cuenta.

Importante

La clase UserInformation no se admite en Windows 10 o posterior. En su lugar, use la clase User . Vea la sección Comentarios.

public ref class UserInformation abstract sealed

/// [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)]
[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

Herencia

Object Platform::Object IInspectable UserInformation

Atributos

ContractVersionAttribute DeprecatedAttribute

Requisitos de Windows

Familia de dispositivos	Windows Desktop Extension SDK (se introdujo en la versión 10.0.10240.0) Windows Mobile Extension SDK (se introdujo en la versión 10.0.10240.0)
API contract	Windows.System.UserProfile.UserProfileContract (se introdujo en la versión v1.0)

Ejemplos

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

Comentarios

Importante

La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar.

Windows 10 Las aplicaciones compiladas para Windows 8 que usan la clase UserInformation ya no devuelven información de usuario al ejecutarse en Windows 10. Esto se debe a que en Windows 10, las aplicaciones no tienen acceso a la información del usuario sin consentimiento explícito del usuario, a diferencia de Windows 8, donde este permiso se concede de forma predeterminada.

Si tienes una aplicación de Windows 8 que usa la clase UserInformation, debes migrar la aplicación a la Plataforma universal de Windows (UWP) y acceder a la clase User en su lugar. Plataforma universal de Windows aplicación (UWP) que acceden a la información del usuario ahora se espera que declare una nueva funcionalidad, uap:userAccountInformation y llame a nuevas API, Windows.System.User.FindAllAsync y User.GetPropertiesAsync, para obtener los datos.

Cuando los usuarios instalan la aplicación, se les pide que permitan el acceso a su información de usuario. Si el usuario permite que la aplicación acceda a la información, la aplicación aparece en la página Privacidad de la interfaz de usuario de configuración de Windows 10 (información de lacuenta deprivacidad>de configuración>). Esto permite a los usuarios de Windows 10 habilitar el acceso a la información del usuario por aplicación.

También puede habilitar el acceso a la información del usuario sin modificaciones de código adicionales mediante la implementación de un cambio de directiva de grupo, que es especialmente útil para los clientes empresariales y empresariales. Para permitir el acceso a la información del usuario en Windows 10, habilite la siguiente configuración de directiva de grupo y establézcala en "Always On": Configuración del > equipo Plantillas > administrativas Perfiles de usuario del sistema Administración de perfiles > de usuario del sistema > de uso compartido de nombre de usuario, imagen de cuenta e información de dominio con aplicaciones (no aplicaciones de escritorio). Para obtener más información, descargue directiva de grupo Referencia de configuración para Windows y Windows Server.

Windows 8 Para iniciarse en modo de imagen de cuenta y para establecer la imagen del usuario sin preguntar más, una aplicación debe registrarse como proveedor de imágenes de cuenta incluyendo lo siguiente en la sección Extensiones del manifiesto de la aplicación.

Propiedades

AccountPictureChangeEnabled	Determina si se puede cambiar la imagen de la cuenta del usuario. Importante La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar. Vea Comentarios en la documentación de la clase UserInformation .
NameAccessAllowed	Permite ver si la aplicación tiene permiso para acceder a la información del usuario. Importante La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar. Vea Comentarios en la documentación de la clase UserInformation .

Métodos

GetAccountPicture(AccountPictureKind)	Obtiene la imagen de la cuenta para el usuario. Importante La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar. Vea Comentarios en la documentación de la clase UserInformation .
GetDisplayNameAsync()	Obtiene el nombre para mostrar de la cuenta de usuario. Importante La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar. Vea Comentarios en la documentación de la clase UserInformation .
GetDomainNameAsync()	Obtiene el nombre de dominio del usuario. Importante La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar. Vea Comentarios en la documentación de la clase UserInformation .
GetFirstNameAsync()	Obtiene el nombre del usuario. Importante La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar. Vea Comentarios en la documentación de la clase UserInformation .
GetLastNameAsync()	Obtiene el apellido del usuario. Importante La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar. Vea Comentarios en la documentación de la clase UserInformation .
GetPrincipalNameAsync()	Obtiene el nombre principal del usuario. Este nombre es el nombre principal de usuario (normalmente la dirección del usuario, aunque esto no siempre es true). Importante La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar. Vea Comentarios en la documentación de la clase UserInformation .
GetSessionInitiationProtocolUriAsync()	Obtiene el identificador uniforme de recursos (URI) del protocolo de inicio de sesión para el usuario. Importante La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar. Vea Comentarios en la documentación de la clase UserInformation .
SetAccountPictureAsync(IStorageFile)	Establece la imagen de la cuenta del usuario mediante un objeto IStorageFile . Importante La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar. Vea Comentarios en la documentación de la clase UserInformation .
SetAccountPictureFromStreamAsync(IRandomAccessStream)	Establece la imagen de la cuenta del usuario mediante un objeto IRandomAccessStream . Importante La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar. Vea Comentarios en la documentación de la clase UserInformation .
SetAccountPicturesAsync(IStorageFile, IStorageFile, IStorageFile)	Establece las imágenes de la cuenta del usuario mediante un objeto IStorageFile . Admite la adición de una imagen pequeña, una imagen grande y un vídeo. Importante La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar. Vea Comentarios en la documentación de la clase UserInformation .
SetAccountPicturesFromStreamsAsync(IRandomAccessStream, IRandomAccessStream, IRandomAccessStream)	Establece las imágenes de la cuenta del usuario mediante un objeto IRandomAccessStream . Admite la adición de una imagen pequeña, una imagen grande y un vídeo. Importante La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar. Vea Comentarios en la documentación de la clase UserInformation .

Eventos

AccountPictureChanged

Se produce cuando cambia la imagen o el nombre del usuario. Importante La clase UserInformation no se admite en Windows 10 o posterior. Use la clase User en su lugar. Vea Comentarios en la documentación de la clase UserInformation .

Consulte también

• User