ClientRoleProvider Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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 static
Thread.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 static
Roles.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ż
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla