Udostępnij za pośrednictwem


ClientRoleProvider Klasa

Definicja

Pobiera informacje o rolach dla aplikacji opartych na systemie Windows z usługi ról 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
Dziedziczenie
ClientRoleProvider

Przykłady

Poniższy przykładowy kod pokazuje, jak za pomocą tej właściwości programowo ustawić lokalizację usługi ról.

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

Uwagi

Za pomocą usług aplikacji klienckich można pobrać informacje o roli z istniejącej usługi ról, konfigurując aplikację do używania ClientRoleProvider klasy. Po skonfigurowaniu można określić, czy uwierzytelniony użytkownik jest w określonej roli, wywołując IsInRole metodę IPrincipal zwracaną przez staticThread.CurrentPrincipal właściwość. W przypadku aplikacji skonfigurowanych do korzystania z usług aplikacji klienckich ta właściwość zwraca wartość ClientRolePrincipal. Ponieważ ta klasa implementuje IPrincipal interfejs, nie trzeba odwoływać się do niego jawnie. Metoda ClientRolePrincipal.IsInRole wewnętrznie wywołuje metodę ClientRoleProvider.IsUserInRole .

Klasa ClientRoleProvider jest dostawcą członkostwa w rolach tylko do odczytu, który pobiera informacje o roli dla uwierzytelnionych użytkowników z usługi ról wskazanej ServiceUri przez właściwość. Wartość ServiceUri właściwości jest zwykle pobierana z pliku konfiguracji aplikacji wraz z innymi wartościami konfiguracji.

Bieżące wystąpienie można pobrać ClientRoleProvider za pośrednictwem staticRoles.Provider właściwości.

Klasa ClientRoleProvider obsługuje tylko GetRolesForUser metody i IsUserInRole klasy abstrakcyjnej RoleProvider . Po wywołaniu jednej z tych metod dla określonego użytkownika dostawca usług najpierw sprawdza lokalną pamięć podręczną danych pod kątem informacji o roli. Jeśli pamięć podręczna nie zawiera żadnych informacji o roli lub pamięć podręczna wygasła, dostawca usługi pobiera informacje o roli z usługi ról i dodaje je do pamięci podręcznej.

Okres limitu czasu dla pamięci podręcznej ról można określić podczas konfigurowania usług aplikacji klienckich. Aby wymusić metodę GetRolesForUser pobierania danych roli z usługi zamiast lokalnej pamięci podręcznej, najpierw wywołaj metodę ResetCache .

Nie można użyć ClientRoleProvider klasy do tworzenia lub usuwania ról ani modyfikowania członkostwa użytkowników w roli. Aby utworzyć lub zmodyfikować informacje o roli, należy zmienić konfigurację usługi roli na serwerze.

Konstruktory

ClientRoleProvider()

Inicjuje nowe wystąpienie klasy ClientRoleProvider.

Właściwości

ApplicationName

Ta właściwość nie jest używana przez tę klasę.

Description

Pobiera krótki, przyjazny opis odpowiedni do wyświetlania w narzędziach administracyjnych lub innych interfejsach użytkownika (UI).

(Odziedziczone po ProviderBase)
Name

Pobiera przyjazną nazwę używaną do odwoływania się do dostawcy podczas konfiguracji.

(Odziedziczone po ProviderBase)
ServiceUri

Pobiera lub ustawia identyfikator URI usługi roli.

Metody

AddUsersToRoles(String[], String[])

Ta metoda nie jest używana przez tę klasę.

CreateRole(String)

Ta metoda nie jest używana przez tę klasę.

DeleteRole(String, Boolean)

Ta metoda nie jest używana przez tę klasę.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
FindUsersInRole(String, String)

Ta metoda nie jest używana przez tę klasę.

GetAllRoles()

Ta metoda nie jest używana przez tę klasę.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetRolesForUser(String)

Pobiera nazwy ról, do których należy określony użytkownik.

GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
GetUsersInRole(String)

Ta metoda nie jest używana przez tę klasę.

Initialize(String, NameValueCollection)

Inicjuje dostawcę.

IsUserInRole(String, String)

Pobiera wartość wskazującą, czy określony użytkownik znajduje się w określonej roli.

MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
RemoveUsersFromRoles(String[], String[])

Ta metoda nie jest używana przez tę klasę.

ResetCache()

Czyści buforowane informacje o roli i resetuje limit czasu pamięci podręcznej.

RoleExists(String)

Ta metoda nie jest używana przez tę klasę.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Zobacz też