UserInformation Classe

Definição

Representa informações sobre o usuário, como nome e imagem da conta.

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Observações.

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
Herança
Object Platform::Object IInspectable UserInformation
Atributos

Requisitos do Windows

Família de dispositivos
Windows Desktop Extension SDK (introduzida na 10.0.10240.0)
Windows Mobile Extension SDK (introduzida na 10.0.10240.0)
API contract
Windows.System.UserProfile.UserProfileContract (introduzida na v1.0)

Exemplos

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

Comentários

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User .

Windows 10 Os aplicativos compilados para o Windows 8 que usam a classe UserInformation não retornam mais informações do usuário durante a execução no Windows 10. Isso ocorre porque, no Windows 10, os aplicativos não têm acesso a informações do usuário sem o consentimento explícito do usuário, ao contrário do Windows 8 em que essa permissão é concedida por padrão.

Se você tiver um aplicativo do Windows 8 que usa a classe UserInformation, deverá migrar seu aplicativo para o Plataforma Universal do Windows (UWP) e acessar a classe User. Plataforma Universal do Windows aplicativo (UWP) que acessa as informações do usuário agora deve declarar uma nova funcionalidade, uap:userAccountInformation, e chamar novas APIs, Windows.System.User.FindAllAsync e User.GetPropertiesAsync, para obter os dados.

Quando os usuários instalam o aplicativo, eles são solicitados a permitir o acesso às informações do usuário. Se o usuário permitir que o aplicativo acesse as informações, o aplicativo aparecerá listado na página Privacidade da interface do usuário configurações do Windows 10 (configurações>informações da Conta dePrivacidade>). Isso permite que os usuários do Windows 10 habilitem o acesso às informações do usuário por aplicativo.

Você também pode habilitar o acesso às informações do usuário sem modificação de código adicional implantando uma alteração de política de grupo, que é particularmente útil para clientes corporativos e empresariais. Para permitir o acesso às informações do usuário no Windows 10, habilite a seguinte configuração de política de grupo e defina-a como "Always On": Configuração > do Computador Modelos Administrativos Perfis > de Usuário do Sistema > Gerenciamento de usuários > de compartilhamento de nome de usuário, imagem de conta e informações de domínio com aplicativos (não aplicativos da área de trabalho). Para obter mais informações, baixe Política de Grupo Referência de Configurações para Windows e Windows Server.

Windows 8 Para ser iniciado no modo de imagem da conta e definir a imagem do usuário sem solicitação adicional, um aplicativo deve se registrar como um provedor de imagens de conta, incluindo o seguinte na seção Extensões do manifesto do aplicativo.

Propriedades

AccountPictureChangeEnabled

Determina se a imagem da conta do usuário pode ser alterada.

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

NameAccessAllowed

Permite que você veja se seu aplicativo tem permissão para acessar as informações do usuário.

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

Métodos

GetAccountPicture(AccountPictureKind)

Obtém a imagem da conta para o usuário.

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

GetDisplayNameAsync()

Obtém o nome de exibição da conta de usuário.

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

GetDomainNameAsync()

Obtém o nome de domínio do usuário.

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

GetFirstNameAsync()

Obtém o nome do usuário.

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

GetLastNameAsync()

Obtém o sobrenome do usuário.

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

GetPrincipalNameAsync()

Obtém o nome principal do usuário. Esse nome é o Nome da Entidade de Usuário (normalmente o endereço do usuário, embora isso nem sempre seja verdadeiro.)

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

GetSessionInitiationProtocolUriAsync()

Obtém o URI (Uniform Resource Identifier) do protocolo de iniciação de sessão para o usuário.

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

SetAccountPictureAsync(IStorageFile)

Define a imagem da conta do usuário usando um objeto IStorageFile .

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

SetAccountPictureFromStreamAsync(IRandomAccessStream)

Define a imagem da conta do usuário usando um objeto IRandomAccessStream .

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

SetAccountPicturesAsync(IStorageFile, IStorageFile, IStorageFile)

Define as imagens da conta do usuário usando um objeto IStorageFile . Dá suporte à adição de uma imagem pequena, uma imagem grande e um vídeo.

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

SetAccountPicturesFromStreamsAsync(IRandomAccessStream, IRandomAccessStream, IRandomAccessStream)

Define as imagens da conta do usuário usando um objeto IRandomAccessStream . Dá suporte à adição de uma imagem pequena, uma imagem grande e um vídeo.

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

Eventos

AccountPictureChanged

Ocorre quando a imagem ou o nome do usuário é alterado.

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

Aplica-se a

Confira também