Поделиться через

UserInformation Класс

  • Ссылка

Определение

Пространство имен:
Windows.System.UserProfile
Изменить

Представляет сведения о пользователе, такие как имя и изображение учетной записи.

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. заметки.

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
Наследование
Object Platform::Object IInspectable UserInformation
Атрибуты
ContractVersionAttribute DeprecatedAttribute

Требования к Windows

Семейство устройств
Windows Desktop Extension SDK (появилось в 10.0.10240.0)
 Windows Mobile Extension SDK (появилось в 10.0.10240.0)
API contract
Windows.System.UserProfile.UserProfileContract (появилось в v1.0)

Примеры

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

Комментарии

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User .

Windows 10 Приложения, скомпилированные для Windows 8, использующие класс UserInformation, больше не возвращают сведения о пользователе при работе в Windows 10. Это связано с тем, что в Windows 10 приложения не имеют доступа к сведениям о пользователе без явного согласия пользователя, в отличие от Windows 8, где это разрешение предоставляется по умолчанию.

Если у вас есть приложение для Windows 8, использующее класс UserInformation, необходимо перенести приложение в универсальная платформа Windows (UWP) и получить доступ к классу User. универсальная платформа Windows приложение (UWP), которое получает доступ к сведениям о пользователе, теперь должно объявить новую возможность uap:userAccountInformation и вызывать новые API Windows.System.User.FindAllAsync и User.GetPropertiesAsync для получения данных.

Когда пользователи устанавливают приложение, им предлагается разрешить доступ к своим пользовательским сведениям. Если пользователь разрешает приложению доступ к информации, приложение отображается на странице Конфиденциальность пользовательского интерфейса параметров Windows 10 (Сведения об учетной записиконфиденциальности>параметров>). Это позволяет пользователям Windows 10 разрешать доступ к пользовательским сведениям для каждого приложения.

Вы также можете включить доступ к сведениям о пользователях без дополнительных изменений кода, развернув изменение групповой политики, что особенно полезно для бизнес-клиентов и корпоративных клиентов. Чтобы разрешить доступ к сведениям о пользователях в Windows 10, включите следующий параметр групповой политики и задайте для него значение "Always On": Конфигурация > компьютера Административные шаблоны > Системные > профили пользователей > Управление именем пользователя, изображением учетной записи и сведениями о домене с приложениями (не классическими приложениями). Для получения дополнительных сведений скачайте групповая политика Справочник по параметрам для Windows и Windows Server.

Windows 8 Чтобы запустить в режиме аватара учетной записи и задать изображение пользователя без дополнительных запросов, приложение должно зарегистрироваться в качестве поставщика рисунков учетной записи, включив следующее в раздел Расширения манифеста приложения.

Свойства

AccountPictureChangeEnabled

Определяет, можно ли изменить изображение учетной записи пользователя.

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. примечания в документации по классу UserInformation .
NameAccessAllowed

Позволяет узнать, разрешен ли вашему приложению доступ к сведениям пользователя.

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. примечания в документации по классу UserInformation .

Методы

GetAccountPicture(AccountPictureKind)

Возвращает изображение учетной записи для пользователя.

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. примечания в документации по классу UserInformation .
GetDisplayNameAsync()

Возвращает отображаемое имя учетной записи пользователя.

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. примечания в документации по классу UserInformation .
GetDomainNameAsync()

Возвращает доменное имя пользователя.

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. примечания в документации по классу UserInformation .
GetFirstNameAsync()

Возвращает имя пользователя.

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. примечания в документации по классу UserInformation .
GetLastNameAsync()

Возвращает фамилию пользователя.

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. примечания в документации по классу UserInformation .
GetPrincipalNameAsync()

Возвращает имя участника для пользователя. Это имя является именем участника-пользователя (обычно это адрес пользователя, хотя это не всегда верно).

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. примечания в документации по классу UserInformation .
GetSessionInitiationProtocolUriAsync()

Возвращает универсальный код ресурса (URI) протокола запуска сеанса для пользователя.

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. примечания в документации по классу UserInformation .
SetAccountPictureAsync(IStorageFile)

Задает изображение для учетной записи пользователя с помощью объекта IStorageFile .

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. примечания в документации по классу UserInformation .
SetAccountPictureFromStreamAsync(IRandomAccessStream)

Задает изображение для учетной записи пользователя с помощью объекта IRandomAccessStream .

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. примечания в документации по классу UserInformation .
SetAccountPicturesAsync(IStorageFile, IStorageFile, IStorageFile)

Задает изображения для учетной записи пользователя с помощью объекта IStorageFile . Поддерживает добавление небольшого изображения, большого изображения и видео.

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. примечания в документации по классу UserInformation .
SetAccountPicturesFromStreamsAsync(IRandomAccessStream, IRandomAccessStream, IRandomAccessStream)

Задает изображения для учетной записи пользователя с помощью объекта IRandomAccessStream . Поддерживает добавление небольшого изображения, большого изображения и видео.

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. примечания в документации по классу UserInformation .

События

AccountPictureChanged

Происходит при изменении образа или имени пользователя.

Важно!

Класс UserInformation не поддерживается в Windows 10 или более поздней версии. Вместо этого используйте класс User . См. примечания в документации по классу UserInformation .

Применяется к

См. также раздел