Share via

ClientRoleProvider Třída

  • Reference

Definice

Obor názvů:
System.Web.ClientServices.Providers
Sestavení:
System.Web.Extensions.dll

Získá informace o rolích pro aplikace založené na systému Windows ze služby rolí 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
Dědičnost
Object
ProviderBase
RoleProvider
ClientRoleProvider

Příklady

Následující ukázkový kód ukazuje, jak tuto vlastnost použít k programovému nastavení umístění služby role.

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

Poznámky

Služby klientských aplikací můžete použít k načtení informací o rolích z existující služby rolí tím, že nakonfigurujete aplikaci tak, aby používala ClientRoleProvider třídu. Po konfiguraci můžete zjistit, jestli je ověřený uživatel v konkrétní roli voláním IsInRole metody IPrincipal vrácené staticThread.CurrentPrincipal vlastností. U aplikací nakonfigurovaných pro používání služeb klientských aplikací vrátí ClientRolePrincipaltato vlastnost hodnotu . Vzhledem k tomu, že tato třída implementuje IPrincipal rozhraní, nemusíte na ni explicitně odkazovat. Metoda ClientRolePrincipal.IsInRole interně volá metodu ClientRoleProvider.IsUserInRole .

Třída ClientRoleProvider je zprostředkovatel členství v rolích jen pro čtení, který načítá informace o rolích pro ověřené uživatele ze služby rolí označené ServiceUri vlastností. Hodnota ServiceUri vlastnosti se obvykle načítá z konfiguračního souboru aplikace spolu s dalšími konfiguračními hodnotami.

Aktuální ClientRoleProvider instanci můžete načíst prostřednictvím staticRoles.Provider vlastnosti .

Třída ClientRoleProvider podporuje pouze GetRolesForUser metody RoleProvider a IsUserInRole abstraktní třídy. Když zavoláte jednu z těchto metod pro konkrétního uživatele, poskytovatel služeb nejprve zkontroluje informace o roli v místní mezipaměti dat. Pokud mezipaměť neobsahuje žádné informace o roli nebo platnost mezipaměti vypršela, poskytovatel služby načte informace o roli ze služby Role a přidá je do mezipaměti.

Při konfiguraci služeb klientských aplikací můžete určit časový limit mezipaměti rolí. Pokud chcete metodu vynutit GetRolesForUser , aby načetla data rolí ze služby místo místní mezipaměti, zavolejte nejprve metodu ResetCache .

Třídu nelze použít ClientRoleProvider k vytváření nebo odstraňování rolí nebo ke změně členství v rolích uživatelů. Pokud chcete vytvořit nebo upravit informace o roli, musíte změnit konfiguraci služby role na serveru.

Konstruktory

ClientRoleProvider()

Inicializuje novou instanci ClientRoleProvider třídy.

Vlastnosti

ApplicationName

Tato vlastnost není používána touto třídou.
Description

Získá stručný popis vhodný pro zobrazení v nástrojích pro správu nebo jiných uživatelských rozhraních (UI).

(Zděděno od ProviderBase)
Name

Získá popisný název použitý k odkaz na poskytovatele během konfigurace.

(Zděděno od ProviderBase)
ServiceUri

Získá nebo nastaví identifikátor URI služby role.

Metody

AddUsersToRoles(String[], String[])

Tato metoda není používána touto třídou.
CreateRole(String)

Tato metoda není používána touto třídou.
DeleteRole(String, Boolean)

Tato metoda není používána touto třídou.
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
FindUsersInRole(String, String)

Tato metoda není používána touto třídou.
GetAllRoles()

Tato metoda není používána touto třídou.
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetRolesForUser(String)

Získá názvy rolí, ke kterým patří zadaný uživatel.
GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
GetUsersInRole(String)

Tato metoda není používána touto třídou.
Initialize(String, NameValueCollection)

Inicializuje poskytovatele.
IsUserInRole(String, String)

Získá hodnotu označující, zda je zadaný uživatel v zadané roli.
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
RemoveUsersFromRoles(String[], String[])

Tato metoda není používána touto třídou.
ResetCache()

Vymaže informace o roli v mezipaměti a resetuje časový limit mezipaměti.
RoleExists(String)

Tato metoda není používána touto třídou.
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Platí pro

Viz také