다음을 통해 공유

ClientRoleProvider 클래스

  • 참조

정의

네임스페이스:
System.Web.ClientServices.Providers
어셈블리:
System.Web.Extensions.dll

Microsoft Ajax 역할 서비스에서 Windows 기반 애플리케이션에 대한 역할 정보를 가져옵니다.

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 속성에서 반환된 IPrincipalIsInRole 메서드를 호출하여 인증된 사용자가 특정 역할에 있는지 여부를 확인할 수 있습니다. 클라이언트 애플리케이션 서비스를 사용하도록 구성된 애플리케이션의 경우 이 속성은 ClientRolePrincipal반환합니다. 이 클래스는 IPrincipal 인터페이스를 구현하므로 명시적으로 참조할 필요가 없습니다. ClientRolePrincipal.IsInRole 메서드는 내부적으로 ClientRoleProvider.IsUserInRole 메서드를 호출합니다.

ClientRoleProvider 클래스는 ServiceUri 속성으로 표시된 역할 서비스에서 인증된 사용자의 역할 정보를 검색하는 읽기 전용 역할 멤버 자격 공급자입니다. ServiceUri 속성의 값은 일반적으로 다른 구성 값과 함께 애플리케이션 구성 파일에서 검색됩니다.

static Roles.Provider 속성을 통해 현재 ClientRoleProvider 인스턴스를 검색할 수 있습니다.

ClientRoleProvider 클래스는 RoleProvider 추상 클래스의 GetRolesForUser 및 IsUserInRole 메서드만 지원합니다. 특정 사용자에 대해 이러한 메서드 중 하나를 호출하는 경우 서비스 공급자는 먼저 로컬 데이터 캐시에서 역할 정보를 확인합니다. 캐시에 역할 정보가 없거나 캐시가 만료된 경우 서비스 공급자는 역할 서비스에서 역할 정보를 검색하여 캐시에 추가합니다.

클라이언트 애플리케이션 서비스를 구성할 때 역할 캐시에 대한 제한 시간을 지정할 수 있습니다. GetRolesForUser 메서드가 로컬 캐시 대신 서비스에서 역할 데이터를 검색하도록 강제하려면 먼저 ResetCache 메서드를 호출합니다.

ClientRoleProvider 클래스를 사용하여 역할을 만들거나 삭제하거나 사용자의 역할 멤버 자격을 수정할 수 없습니다. 역할 정보를 만들거나 수정하려면 서버에서 역할 서비스의 구성을 변경해야 합니다.

생성자

ClientRoleProvider()

ClientRoleProvider 클래스의 새 인스턴스를 초기화합니다.

속성

ApplicationName

이 속성은 이 클래스에서 사용되지 않습니다.
Description

관리 도구 또는 기타 UI(사용자 인터페이스)에 표시하기에 적합한 짧고 친숙한 설명을 가져옵니다.

(다음에서 상속됨 ProviderBase)
Name

구성 중에 공급자를 참조하는 데 사용되는 이름을 가져옵니다.

(다음에서 상속됨 ProviderBase)
ServiceUri

역할 서비스의 URI를 가져오거나 설정합니다.

메서드

AddUsersToRoles(String[], String[])

이 메서드는 이 클래스에서 사용되지 않습니다.
CreateRole(String)

이 메서드는 이 클래스에서 사용되지 않습니다.
DeleteRole(String, Boolean)

이 메서드는 이 클래스에서 사용되지 않습니다.
Equals(Object)

지정된 개체가 현재 개체와 같은지 여부를 확인합니다.

(다음에서 상속됨 Object)
FindUsersInRole(String, String)

이 메서드는 이 클래스에서 사용되지 않습니다.
GetAllRoles()

이 메서드는 이 클래스에서 사용되지 않습니다.
GetHashCode()

기본 해시 함수로 사용됩니다.

(다음에서 상속됨 Object)
GetRolesForUser(String)

지정된 사용자가 속한 역할의 이름을 가져옵니다.
GetType()

현재 인스턴스의 Type 가져옵니다.

(다음에서 상속됨 Object)
GetUsersInRole(String)

이 메서드는 이 클래스에서 사용되지 않습니다.
Initialize(String, NameValueCollection)

공급자를 초기화합니다.
IsUserInRole(String, String)

지정된 사용자가 지정된 역할에 있는지 여부를 나타내는 값을 가져옵니다.
MemberwiseClone()

현재 Object단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
RemoveUsersFromRoles(String[], String[])

이 메서드는 이 클래스에서 사용되지 않습니다.
ResetCache()

캐시된 역할 정보를 지우고 캐시 제한 시간을 다시 설정합니다.
RoleExists(String)

이 메서드는 이 클래스에서 사용되지 않습니다.
ToString()

현재 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 Object)

적용 대상

추가 정보