UserInformation クラス

リファレンス

定義

名前空間:: Windows.System.UserProfile

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

名前やアカウントの画像など、ユーザーに関する情報を表します。

重要

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 UserInformation クラスを使用する Windows 8 用にコンパイルされたアプリは、Windows 10で実行するときにユーザー情報を返さなくなりました。これは、Windows 10では、このアクセス許可が既定で付与される Windows 8 とは異なり、アプリは明示的なユーザーの同意なしにユーザー情報にアクセスできないためです。

UserInformation クラスを使用する Windows 8 アプリがある場合は、アプリをユニバーサル Windows プラットフォーム (UWP) に移行し、代わりに User クラスにアクセスする必要があります。ユーザー情報にアクセスするユニバーサル Windows プラットフォーム (UWP) アプリでは、新しい機能 uap:userAccountInformation を宣言し、新しい API である Windows.System.User.FindAllAsync と User.GetPropertiesAsync を呼び出してデータを取得する必要があります。

ユーザーがアプリをインストールすると、ユーザー情報へのアクセスを許可するように求められます。ユーザーがアプリに情報へのアクセスを許可すると、アプリはWindows 10設定 UI の [プライバシー] ページに表示されます ([設定] [プライバシー>アカウント情報]> )。これにより、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()	ユーザーのセッション開始プロトコルの Uniform Resource Identifier (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 クラスのドキュメントの「解説」を参照してください。

適用対象

こちらもご覧ください

User