Sdílet prostřednictvím

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 rolí.

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

Klientské aplikační služby můžete použít k načtení informací o rolích z existující služby rolí tak, že aplikaci nakonfigurujete tak, aby používala třídu ClientRoleProvider. Po konfiguraci můžete určit, jestli je ověřený uživatel v určité roli voláním IsInRole metody IPrincipal vrácenou vlastností staticThread.CurrentPrincipal. Pro aplikace nakonfigurované tak, aby používaly klientské aplikační služby, vrátí tato vlastnost ClientRolePrincipal. Vzhledem k tomu, že tato třída implementuje rozhraní IPrincipal, není nutné na něj explicitně odkazovat. Metoda ClientRolePrincipal.IsInRole interně volá metodu ClientRoleProvider.IsUserInRole.

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

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

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

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

Třídu ClientRoleProvider nelze použít k vytvoření nebo odstranění rolí nebo ke změně členství v rolích uživatelů. Chcete-li vytvořit nebo upravit informace o rolích, 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 odkazování na zprostředkovatele 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čuje, zda je zadaný objekt roven 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í funkce hash.

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

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

Získá Type aktuální instance.

(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 určující, zda zadaný uživatel je v zadané roli.
MemberwiseClone()

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

(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é