UserInformation Klasse

Definition

Namespace:

Windows.System.UserProfile

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

Vererbung

Object Platform::Object IInspectable UserInformation

Attribute

ContractVersionAttribute DeprecatedAttribute

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 .

Weitere Informationen

• User