UserInformation Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- 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 . |