UserInformation Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- Warisan
- Atribut
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 . |