ClientRoleProvider Kelas

Referensi

Definisi

Ruang nama:: System.Web.ClientServices.Providers

Rakitan:: System.Web.Extensions.dll

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.

Mendapatkan informasi peran untuk aplikasi berbasis Windows dari layanan peran Microsoft Ajax.

public ref class ClientRoleProvider : System::Web::Security::RoleProvider

public class ClientRoleProvider : System.Web.Security.RoleProvider

type ClientRoleProvider = class
    inherit RoleProvider

Public Class ClientRoleProvider
Inherits RoleProvider

Warisan: Object

ProviderBase

RoleProvider
ClientRoleProvider

Contoh

Contoh kode berikut menunjukkan cara menggunakan properti ini untuk mengatur lokasi layanan peran secara terprogram.

private void SetRolesServiceLocation()
{
    ((ClientRoleProvider)System.Web.Security.Roles.Provider).ServiceUri = 
        "http://localhost:55555/AppServices/Role_JSON_AppService.axd";
}

Private Sub SetRolesServiceLocation()
    CType(System.Web.Security.Roles.Provider,  _
        ClientRoleProvider).ServiceUri = _
        "http://localhost:55555/AppServices/Role_JSON_AppService.axd"
End Sub

Keterangan

Anda dapat menggunakan layanan aplikasi klien untuk mengambil informasi peran dari layanan peran yang ada dengan mengonfigurasi aplikasi Anda untuk menggunakan ClientRoleProvider kelas . Setelah konfigurasi, Anda dapat menentukan apakah pengguna yang diautentikasi berada dalam peran tertentu dengan memanggil IsInRole metode yang IPrincipal dikembalikan oleh staticThread.CurrentPrincipal properti . Untuk aplikasi yang dikonfigurasi untuk menggunakan layanan aplikasi klien, properti ini mengembalikan ClientRolePrincipal. Karena kelas ini mengimplementasikan IPrincipal antarmuka, Anda tidak perlu mereferensikannya secara eksplisit. Metode ini ClientRolePrincipal.IsInRole secara internal memanggil ClientRoleProvider.IsUserInRole metode .

Kelas ClientRoleProvider adalah penyedia keanggotaan peran baca-saja yang mengambil informasi peran untuk pengguna terautentikasi dari layanan peran yang ditunjukkan oleh ServiceUri properti . Nilai ServiceUri properti biasanya diambil dari file konfigurasi aplikasi bersama dengan nilai konfigurasi lainnya.

Anda dapat mengambil instans saat ini ClientRoleProvider melalui staticRoles.Provider properti .

Kelas ClientRoleProvider hanya GetRolesForUser mendukung metode dan IsUserInRole dari RoleProvider kelas abstrak. Ketika Anda memanggil salah satu metode ini untuk pengguna tertentu, penyedia layanan terlebih dahulu memeriksa cache data lokal untuk informasi peran. Jika cache tidak berisi informasi peran apa pun atau cache telah kedaluwarsa, penyedia layanan mengambil informasi peran dari layanan peran dan menambahkannya ke cache.

Anda dapat menentukan periode waktu habis untuk cache peran saat mengonfigurasi layanan aplikasi klien. Untuk memaksa GetRolesForUser metode mengambil data peran dari layanan alih-alih cache lokal, panggil metode terlebih ResetCache dahulu.

Anda tidak dapat menggunakan ClientRoleProvider kelas untuk membuat atau menghapus peran, atau untuk mengubah keanggotaan peran pengguna. Untuk membuat atau mengubah informasi peran, Anda harus mengubah konfigurasi layanan peran di server.

Konstruktor

ClientRoleProvider()

Menginisialisasi instans baru kelas ClientRoleProvider.

Properti

ApplicationName	Properti ini tidak digunakan oleh kelas ini.
Description	Mendapatkan deskripsi singkat dan ramah yang cocok untuk ditampilkan di alat administratif atau antarmuka pengguna (UI) lainnya. (Diperoleh dari ProviderBase)
Name	Mendapatkan nama ramah yang digunakan untuk merujuk ke penyedia selama konfigurasi. (Diperoleh dari ProviderBase)
ServiceUri	Mendapatkan atau mengatur URI layanan peran.

Metode

AddUsersToRoles(String[], String[])	Metode ini tidak digunakan oleh kelas ini.
CreateRole(String)	Metode ini tidak digunakan oleh kelas ini.
DeleteRole(String, Boolean)	Metode ini tidak digunakan oleh kelas ini.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FindUsersInRole(String, String)	Metode ini tidak digunakan oleh kelas ini.
GetAllRoles()	Metode ini tidak digunakan oleh kelas ini.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetRolesForUser(String)	Mendapatkan nama peran tempat pengguna yang ditentukan berada.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
GetUsersInRole(String)	Metode ini tidak digunakan oleh kelas ini.
Initialize(String, NameValueCollection)	Menginisialisasi penyedia.
IsUserInRole(String, String)	Mendapatkan nilai yang menunjukkan apakah pengguna yang ditentukan berada dalam peran yang ditentukan.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
RemoveUsersFromRoles(String[], String[])	Metode ini tidak digunakan oleh kelas ini.
ResetCache()	Menghapus informasi peran yang di-cache dan mengatur ulang periode waktu habis cache.
RoleExists(String)	Metode ini tidak digunakan oleh kelas ini.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk

Bagikan melalui