UserInformation Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
- Ereditarietà
- Attributi
Requisiti Windows
Famiglia di dispositivi |
Windows Desktop Extension SDK (è stato introdotto in 10.0.10240.0)
Windows Mobile Extension SDK (è stato introdotto in 10.0.10240.0) |
API contract |
Windows.System.UserProfile.UserProfileContract (è stato introdotto in v1.0)
|
Esempio
function getUserInfo() {
image = Windows.System.UserProfile.UserInformation.getAccountPicture(Windows.System.UserProfile.AccountPictureKind.smallImage);
imageURL = URL.createObjectURL(image, false);
}
Commenti
Importante
La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User .
Windows 10 App compilate per Windows 8 che usano la classe UserInformation non restituiscono più informazioni utente durante l'esecuzione in Windows 10. Ciò avviene perché in Windows 10 le app non hanno accesso alle informazioni utente senza consenso esplicito dell'utente, a differenza di Windows 8 in cui questa autorizzazione viene concessa per impostazione predefinita.
Se si dispone di un'app windows 8 che usa la classe UserInformation, è consigliabile eseguire la migrazione dell'app alla piattaforma UWP (Universal Windows Platform) (UWP) e accedere alla classe User. piattaforma UWP (Universal Windows Platform) app UWP (UWP) che accedono alle informazioni utente devono ora dichiarare una nuova funzionalità, uap:userAccountInformation e chiamare nuove API, Windows.System.User.FindAllAsync e User.GetPropertiesAsync, per ottenere i dati.
Quando gli utenti installano l'app, viene richiesto di consentire l'accesso alle informazioni utente. Se l'utente consente all'app di accedere alle informazioni, l'app viene visualizzata nella pagina Privacy dell'interfaccia utente delle impostazioni di Windows 10 (Informazioni>sull'accountprivacy>). Ciò consente agli utenti di Windows 10 di abilitare l'accesso alle informazioni utente in base a ogni app.
È anche possibile abilitare l'accesso alle informazioni utente senza modifiche di codice aggiuntive distribuendo una modifica dei criteri di gruppo, particolarmente utile per i clienti aziendali e aziendali. Per consentire l'accesso alle informazioni utente su Windows 10, abilitare l'impostazione dei criteri di gruppo seguente e impostarla su "Always On": > Configurazione computer Modelli >> amministrativi Profili utente Gestione profili utente > di condivisione nome utente, immagine dell'account e informazioni di dominio con app (non app desktop). Per altre info, scaricare Criteri di gruppo Informazioni di riferimento sulle impostazioni per Windows e Windows Server.
Windows 8 Per essere avviato in modalità immagine dell'account e per impostare l'immagine dell'utente senza richiedere ulteriore conferma, un'app deve registrarsi come provider di immagini dell'account includendo quanto segue nella sezione Estensioni del manifesto dell'app.
Proprietà
AccountPictureChangeEnabled |
Determina se l'immagine dell'account dell'utente può essere modificata. Importante La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User . Vedere Osservazioni nella documentazione della classe UserInformation . |
NameAccessAllowed |
Consente di verificare se l'app è consentita per accedere alle informazioni dell'utente. Importante La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User . Vedere Osservazioni nella documentazione della classe UserInformation . |
Metodi
GetAccountPicture(AccountPictureKind) |
Ottiene l'immagine dell'account per l'utente. Importante La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User . Vedere Osservazioni nella documentazione della classe UserInformation . |
GetDisplayNameAsync() |
Ottiene il nome visualizzato per l'account utente. Importante La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User . Vedere Osservazioni nella documentazione della classe UserInformation . |
GetDomainNameAsync() |
Ottiene il nome di dominio per l'utente. Importante La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User . Vedere Osservazioni nella documentazione della classe UserInformation . |
GetFirstNameAsync() |
Ottiene il nome dell'utente. Importante La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User . Vedere Osservazioni nella documentazione della classe UserInformation . |
GetLastNameAsync() |
Ottiene il cognome dell'utente. Importante La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User . Vedere Osservazioni nella documentazione della classe UserInformation . |
GetPrincipalNameAsync() |
Ottiene il nome dell'entità per l'utente. Questo nome è il nome dell'entità utente (in genere l'indirizzo dell'utente, anche se questo non è sempre true). Importante La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User . Vedere Osservazioni nella documentazione della classe UserInformation . |
GetSessionInitiationProtocolUriAsync() |
Ottiene l'URI (Uniform Resource Identifier) del protocollo di avvio della sessione per l'utente. Importante La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User . Vedere Osservazioni nella documentazione della classe UserInformation . |
SetAccountPictureAsync(IStorageFile) |
Imposta l'immagine per l'account dell'utente usando un oggetto IStorageFile . Importante La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User . Vedere Osservazioni nella documentazione della classe UserInformation . |
SetAccountPictureFromStreamAsync(IRandomAccessStream) |
Imposta l'immagine per l'account dell'utente usando un oggetto IRandomAccessStream . Importante La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User . Vedere Osservazioni nella documentazione della classe UserInformation . |
SetAccountPicturesAsync(IStorageFile, IStorageFile, IStorageFile) |
Imposta le immagini per l'account dell'utente usando un oggetto IStorageFile . Supporta l'aggiunta di un'immagine piccola, un'immagine di grandi dimensioni e un video. Importante La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User . Vedere Osservazioni nella documentazione della classe UserInformation . |
SetAccountPicturesFromStreamsAsync(IRandomAccessStream, IRandomAccessStream, IRandomAccessStream) |
Imposta le immagini per l'account dell'utente usando un oggetto IRandomAccessStream . Supporta l'aggiunta di un'immagine piccola, un'immagine di grandi dimensioni e un video. Importante La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User . Vedere Osservazioni nella documentazione della classe UserInformation . |
Eventi
AccountPictureChanged |
Si verifica quando l'immagine o il nome dell'utente cambia. Importante La classe UserInformation non è supportata in Windows 10 o versioni successive. Usare invece la classe User . Vedere Osservazioni nella documentazione della classe UserInformation . |