UserInformation Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Informationen zum Benutzer dar, z. B. Name und Kontobild.
Wichtig
Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Siehe Hinweise.
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
- Vererbung
- Attribute
Windows-Anforderungen
Gerätefamilie |
Windows Desktop Extension SDK (eingeführt in 10.0.10240.0)
Windows Mobile Extension SDK (eingeführt in 10.0.10240.0) |
API contract |
Windows.System.UserProfile.UserProfileContract (eingeführt in v1.0)
|
Beispiele
function getUserInfo() {
image = Windows.System.UserProfile.UserInformation.getAccountPicture(Windows.System.UserProfile.AccountPictureKind.smallImage);
imageURL = URL.createObjectURL(image, false);
}
Hinweise
Wichtig
Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse .
Windows 10 Für Windows 8 kompilierte Apps, die die UserInformation-Klasse verwenden, geben keine Benutzerinformationen mehr zurück, wenn sie unter Windows 10 ausgeführt werden. Dies liegt daran, dass Apps in Windows 10 ohne explizite Benutzerzustimmung keinen Zugriff auf Benutzerinformationen haben, im Gegensatz zu Windows 8, bei dem diese Berechtigung standardmäßig erteilt wird.
Wenn Sie über eine Windows 8-App verfügen, die die UserInformation-Klasse verwendet, sollten Sie Ihre App zur Universelle Windows-Plattform (UWP) migrieren und stattdessen auf die User-Klasse zugreifen. Universelle Windows-Plattform-App (UWP), die auf Benutzerinformationen zugreifen, wird nun erwartet, dass sie eine neue Funktion , uap:userAccountInformation, deklarieren und neue APIs aufrufen, Windows.System.User.FindAllAsync und User.GetPropertiesAsync, um die Daten abzurufen.
Wenn Benutzer die App installieren, werden sie aufgefordert, den Zugriff auf ihre Benutzerinformationen zuzulassen. Wenn der Benutzer der App den Zugriff auf die Informationen zulässt, wird die App auf der SeiteDatenschutz auf der Benutzeroberfläche für Windows 10 Einstellungen (Datenschutzkontoinformationen für Einstellungen>>) angezeigt. Dadurch können Windows 10 Benutzer den Zugriff auf Benutzerinformationen pro App ermöglichen.
Sie können auch den Zugriff auf Benutzerinformationen ohne zusätzliche Codeänderungen ermöglichen, indem Sie eine Gruppenrichtlinienänderung bereitstellen, die besonders für Geschäfts- und Unternehmenskunden nützlich ist. Um den Zugriff auf Benutzerinformationen auf Windows 10 zuzulassen, aktivieren Sie die folgende Gruppenrichtlinieneinstellung, und legen Sie sie auf "Always On" fest: Computerkonfiguration > administrative Vorlagen > Systembenutzerprofile >> Benutzerverwaltung des Freigebens von Benutzernamen, Kontobild und Domäneninformationen für Apps (keine Desktop-Apps). Weitere Informationen finden Sie unter Gruppenrichtlinie Einstellungsreferenz für Windows und Windows Server.
Windows 8 Um im Kontobildmodus gestartet zu werden und das Bild des Benutzers ohne zusätzliche Aufforderung festzulegen, muss sich eine App als Kontobildanbieter registrieren, indem sie folgendes in den Abschnitt Erweiterungen des App-Manifests einschließt.
Eigenschaften
AccountPictureChangeEnabled |
Bestimmt, ob das Kontobild des Benutzers geändert werden kann. Wichtig Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse . |
NameAccessAllowed |
Ermöglicht Es Ihnen, zu sehen, ob Ihre App auf die Benutzerinformationen zugreifen darf. Wichtig Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse . |
Methoden
GetAccountPicture(AccountPictureKind) |
Ruft das Kontobild für den Benutzer ab. Wichtig Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse . |
GetDisplayNameAsync() |
Ruft den Anzeigenamen für das Benutzerkonto ab. Wichtig Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse . |
GetDomainNameAsync() |
Ruft den Domänennamen für den Benutzer ab. Wichtig Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse . |
GetFirstNameAsync() |
Ruft den Vornamen des Benutzers ab. Wichtig Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse . |
GetLastNameAsync() |
Ruft den Nachnamen des Benutzers ab. Wichtig Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse . |
GetPrincipalNameAsync() |
Ruft den Prinzipalnamen für den Benutzer ab. Dieser Name ist der Benutzerprinzipalname (in der Regel die Adresse des Benutzers, obwohl dies nicht immer der Fall ist).) Wichtig Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse . |
GetSessionInitiationProtocolUriAsync() |
Ruft den Uniform Resource Identifier (URI) des Sitzungsinitiierungsprotokolls für den Benutzer ab. Wichtig Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse . |
SetAccountPictureAsync(IStorageFile) |
Legt das Bild für das Konto des Benutzers mithilfe eines IStorageFile-Objekts fest. Wichtig Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse . |
SetAccountPictureFromStreamAsync(IRandomAccessStream) |
Legt das Bild für das Konto des Benutzers mithilfe eines IRandomAccessStream-Objekts fest. Wichtig Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse . |
SetAccountPicturesAsync(IStorageFile, IStorageFile, IStorageFile) |
Legt die Bilder für das Konto des Benutzers mithilfe eines IStorageFile-Objekts fest. Unterstützt das Hinzufügen eines kleinen Bilds, eines großen Bilds und eines Videos. Wichtig Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse . |
SetAccountPicturesFromStreamsAsync(IRandomAccessStream, IRandomAccessStream, IRandomAccessStream) |
Legt die Bilder für das Konto des Benutzers mithilfe eines IRandomAccessStream-Objekts fest. Unterstützt das Hinzufügen eines kleinen Bilds, eines großen Bilds und eines Videos. Wichtig Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse . |
Ereignisse
AccountPictureChanged |
Tritt auf, wenn sich das Image oder der Name des Benutzers ändert. Wichtig Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse . |