Bagikan melalui

ClientRoleProvider Kelas

  • Referensi

Definisi

Ruang nama:
System.Web.ClientServices.Providers
Rakitan:
System.Web.Extensions.dll

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 kelas ClientRoleProvider. Setelah konfigurasi, Anda dapat menentukan apakah pengguna yang diautentikasi berada dalam peran tertentu dengan memanggil metode IsInRoleIPrincipal yang dikembalikan oleh properti staticThread.CurrentPrincipal. Untuk aplikasi yang dikonfigurasi untuk menggunakan layanan aplikasi klien, properti ini mengembalikan ClientRolePrincipal. Karena kelas ini mengimplementasikan antarmuka IPrincipal, Anda tidak perlu mereferensikannya secara eksplisit. Metode ClientRolePrincipal.IsInRole secara internal memanggil metode ClientRoleProvider.IsUserInRole.

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

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

Kelas ClientRoleProvider hanya mendukung metode GetRolesForUser dan IsUserInRole dari kelas abstrak RoleProvider. 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 metode GetRolesForUser mengambil data peran dari layanan alih-alih cache lokal, panggil metode ResetCache terlebih dahulu.

Anda tidak dapat menggunakan kelas ClientRoleProvider 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 yang mudah diingat 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 milik pengguna yang ditentukan.
GetType()

Mendapatkan Type instans 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 Objectsaat ini.

(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

Lihat juga