ClientRoleProvider Klas

Definitie

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

Overname

Object

ProviderBase

RoleProvider

ClientRoleProvider

Voorbeelden

De volgende voorbeeldcode laat zien hoe u deze eigenschap gebruikt om de locatie van de functieservice programmatisch in te stellen.

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

Opmerkingen

U kunt clienttoepassingsservices gebruiken om rolgegevens op te halen uit een bestaande functieservice door uw toepassing te configureren voor gebruik van de ClientRoleProvider klasse. Na de configuratie kunt u bepalen of een geverifieerde gebruiker een bepaalde rol heeft door de IsInRole methode aan te roepen van de IPrincipal geretourneerde staticThread.CurrentPrincipal eigenschap. Voor toepassingen die zijn geconfigureerd voor het gebruik van clienttoepassingsservices, retourneert deze eigenschap een ClientRolePrincipal. Omdat deze klasse de IPrincipal interface implementeert, hoeft u er niet expliciet naar te verwijzen. De ClientRolePrincipal.IsInRole methode roept de methode intern aan ClientRoleProvider.IsUserInRole .

De ClientRoleProvider klasse is een alleen-lezen rollidmaatschapsprovider die rolgegevens voor geverifieerde gebruikers ophaalt uit de rollenservice die wordt aangegeven door de ServiceUri eigenschap. De waarde van de eigenschap wordt doorgaans opgehaald uit het configuratiebestand van de ServiceUri toepassing, samen met andere configuratiewaarden.

U kunt het huidige ClientRoleProvider exemplaar ophalen via de staticRoles.Provider eigenschap.

De ClientRoleProvider klasse ondersteunt alleen de GetRolesForUser en IsUserInRole methoden van de RoleProvider abstracte klasse. Wanneer u een van deze methoden aanroept voor een bepaalde gebruiker, controleert de serviceprovider eerst de lokale gegevenscache op rolgegevens. Als de cache geen rolgegevens bevat of de cache is verlopen, haalt de serviceprovider de rolgegevens op uit de functieservice en voegt deze toe aan de cache.

U kunt de time-outperiode voor de rollencache opgeven wanneer u clienttoepassingsservices configureert. Als u wilt afdwingen dat de GetRolesForUser methode rolgegevens ophaalt uit de service in plaats van de lokale cache, roept u eerst de ResetCache methode aan.

U kunt de ClientRoleProvider klasse niet gebruiken om rollen te maken of te verwijderen of om het rollidmaatschap van gebruikers te wijzigen. Als u functiegegevens wilt maken of wijzigen, moet u de configuratie van de functieservice op de server wijzigen.

Zie ook

• CurrentPrincipal
• ClientRolePrincipal
• IsInRole(String)
• ServiceUri
• GetRolesForUser(String)
• IsUserInRole(String, String)
• ResetCache()
• Client Application Services
• Procedure: Client Application Services configureren