ClientRoleProvider 類別

定義

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

繼承

Object

ProviderBase

RoleProvider

ClientRoleProvider

範例

下列範例程式代碼示範如何使用這個屬性，以程式設計方式設定角色服務位置。

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

備註

您可以使用用戶端應用程式服務，藉由將應用程式設定為使用 ClientRoleProvider 類別，從現有的角色服務擷取角色資訊。 設定之後，您可以呼叫 staticThread.CurrentPrincipal 屬性所傳回之 IPrincipal 的 IsInRole 方法，判斷已驗證的使用者是否處於特定角色。 針對設定為使用用戶端應用程式服務的應用程式，此屬性會傳回 ClientRolePrincipal。 因為這個類別會實作 IPrincipal 介面，所以您不需要明確地參考它。 ClientRolePrincipal.IsInRole 方法會在內部呼叫 ClientRoleProvider.IsUserInRole 方法。

ClientRoleProvider 類別是唯讀角色成員資格提供者，可從 ServiceUri 屬性所指示的角色服務中擷取已驗證使用者的角色資訊。 ServiceUri 屬性的值通常會與其他組態值一起從應用程式組態檔擷取。

您可以透過 staticRoles.Provider 屬性擷取目前 ClientRoleProvider 實例。

ClientRoleProvider 類別僅支援 RoleProvider 抽象類的 GetRolesForUser 和 IsUserInRole 方法。 當您針對特定使用者呼叫其中一種方法時，服務提供者會先檢查本機數據快取中是否有角色資訊。 如果快取未包含任何角色資訊或快取已過期，服務提供者會從角色服務擷取角色資訊，並將它新增至快取。

您可以在設定用戶端應用程式服務時，指定角色快取的逾時期間。 若要強制 GetRolesForUser 方法從服務擷取角色數據，而不是本機快取，請先呼叫 ResetCache 方法。

您無法使用 ClientRoleProvider 類別來建立或刪除角色，或修改使用者的角色成員資格。 若要建立或修改角色資訊，您必須變更伺服器上的角色服務組態。

建構函式

屬性

方法

適用於

另請參閱

• CurrentPrincipal
• ClientRolePrincipal
• IsInRole(String)
• ServiceUri
• GetRolesForUser(String)
• IsUserInRole(String, String)
• ResetCache()
• 用戶端應用程式服務
• 如何：設定用戶端應用程式服務