UserInformation Kelas

Definisi

Ruang nama:

Windows.System.UserProfile

Mewakili informasi tentang pengguna, seperti nama dan gambar akun.

Penting

Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan.

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

Warisan

Object Platform::Object IInspectable UserInformation

Atribut

ContractVersionAttribute DeprecatedAttribute

Persyaratan Windows

Rangkaian perangkat	Windows Desktop Extension SDK (diperkenalkan dalam 10.0.10240.0) Windows Mobile Extension SDK (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.System.UserProfile.UserProfileContract (diperkenalkan dalam v1.0)

Contoh

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

Keterangan

Penting

Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya.

Windows 10 Apps yang dikompilasi untuk Windows 8 yang menggunakan kelas UserInformation tidak lagi mengembalikan informasi pengguna saat berjalan di Windows 10. Ini karena dalam Windows 10, aplikasi tidak memiliki akses ke informasi pengguna tanpa persetujuan pengguna eksplisit, tidak seperti di Windows 8 di mana izin ini diberikan secara default.

Jika Anda memiliki aplikasi Windows 8 yang menggunakan kelas UserInformation, Anda harus memigrasikan aplikasi Anda ke Platform Windows Universal (UWP) dan mengakses kelas Pengguna sebagai gantinya. aplikasi Platform Windows Universal (UWP) yang mengakses informasi pengguna sekarang diharapkan untuk mendeklarasikan kemampuan baru, uap:userAccountInformation, dan memanggil API baru, Windows.System.User.FindAllAsync dan User.GetPropertiesAsync, untuk mendapatkan data.

Saat pengguna menginstal aplikasi, mereka diminta untuk mengizinkan akses ke informasi pengguna mereka. Jika pengguna mengizinkan aplikasi mengakses informasi, aplikasi akan muncul tercantum di halaman Privasi UI Pengaturan Windows 10 (info AkunPrivasi>Pengaturan>). Ini memungkinkan Windows 10 pengguna untuk mengaktifkan akses ke informasi pengguna berdasarkan per aplikasi.

Anda juga dapat mengaktifkan akses ke informasi pengguna tanpa modifikasi kode tambahan dengan menyebarkan perubahan kebijakan grup, yang sangat berguna untuk pelanggan bisnis dan perusahaan. Untuk mengizinkan akses ke informasi pengguna di Windows 10, aktifkan pengaturan kebijakan grup berikut dan atur ke "Always On": Templat Administratif Konfigurasi > Komputer Manajemen pengguna Profil > Pengguna Sistem > berbagi nama pengguna, gambar akun, dan informasi domain dengan aplikasi (bukan aplikasi desktop).> Untuk informasi selengkapnya, unduh Referensi Pengaturan Kebijakan Grup untuk Windows dan Windows Server.

Windows 8 Untuk diluncurkan dalam mode gambar akun dan untuk mengatur gambar pengguna tanpa permintaan tambahan, aplikasi harus mendaftar sebagai penyedia gambar akun dengan menyertakan yang berikut ini di bagian Ekstensi dari manifes aplikasi.

Properti

AccountPictureChangeEnabled	Menentukan apakah gambar akun pengguna dapat diubah. Penting Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan dalam dokumentasi kelas UserInformation .
NameAccessAllowed	Memungkinkan Anda melihat apakah aplikasi Anda diizinkan untuk mengakses informasi pengguna. Penting Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan dalam dokumentasi kelas UserInformation .

Metode

GetAccountPicture(AccountPictureKind)	Mendapatkan gambar akun untuk pengguna. Penting Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan dalam dokumentasi kelas UserInformation .
GetDisplayNameAsync()	Mendapatkan nama tampilan untuk akun pengguna. Penting Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan dalam dokumentasi kelas UserInformation .
GetDomainNameAsync()	Mendapatkan nama domain untuk pengguna. Penting Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan dalam dokumentasi kelas UserInformation .
GetFirstNameAsync()	Mendapatkan nama depan pengguna. Penting Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan dalam dokumentasi kelas UserInformation .
GetLastNameAsync()	Mendapatkan nama belakang pengguna. Penting Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan dalam dokumentasi kelas UserInformation .
GetPrincipalNameAsync()	Mendapatkan nama utama untuk pengguna. Nama ini adalah Nama Prinsipal Pengguna (biasanya alamat pengguna, meskipun ini tidak selalu benar.) Penting Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan dalam dokumentasi kelas UserInformation .
GetSessionInitiationProtocolUriAsync()	Mendapatkan Pengidentifikasi Sumber Daya Seragam (URI) dari protokol inisiasi sesi untuk pengguna. Penting Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan dalam dokumentasi kelas UserInformation .
SetAccountPictureAsync(IStorageFile)	Mengatur gambar untuk akun pengguna menggunakan objek IStorageFile . Penting Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan dalam dokumentasi kelas UserInformation .
SetAccountPictureFromStreamAsync(IRandomAccessStream)	Mengatur gambar untuk akun pengguna menggunakan objek IRandomAccessStream . Penting Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan dalam dokumentasi kelas UserInformation .
SetAccountPicturesAsync(IStorageFile, IStorageFile, IStorageFile)	Mengatur gambar untuk akun pengguna menggunakan objek IStorageFile . Mendukung penambahan gambar kecil, gambar besar, dan video. Penting Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan dalam dokumentasi kelas UserInformation .
SetAccountPicturesFromStreamsAsync(IRandomAccessStream, IRandomAccessStream, IRandomAccessStream)	Mengatur gambar untuk akun pengguna menggunakan objek IRandomAccessStream . Mendukung penambahan gambar kecil, gambar besar, dan video. Penting Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan dalam dokumentasi kelas UserInformation .

Acara

AccountPictureChanged

Terjadi saat gambar atau nama pengguna berubah. Penting Kelas UserInformation tidak didukung pada Windows 10 atau yang lebih baru. Gunakan kelas Pengguna sebagai gantinya. Lihat Keterangan dalam dokumentasi kelas UserInformation .

Lihat juga

• User