Aracılığıyla paylaş

ClientRoleProvider Sınıf

  • Başvuru

Tanım

Ad Alanı:
System.Web.ClientServices.Providers
Bütünleştirilmiş Kod:
System.Web.Extensions.dll

Microsoft Ajax rol hizmetinden Windows tabanlı uygulamalar için rol bilgilerini alır.

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
Devralma
Object
ProviderBase
RoleProvider
ClientRoleProvider

Örnekler

Aşağıdaki örnek kod, rol hizmeti konumunu program aracılığıyla ayarlamak için bu özelliğin nasıl kullanılacağını gösterir.

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

Açıklamalar

Uygulamanızı ClientRoleProvider sınıfını kullanacak şekilde yapılandırarak mevcut bir rol hizmetinden rol bilgilerini almak için istemci uygulama hizmetlerini kullanabilirsiniz. Yapılandırmadan sonra, staticThread.CurrentPrincipal özelliği tarafından döndürülen IPrincipalIsInRole yöntemini çağırarak kimliği doğrulanmış bir kullanıcının belirli bir rolde olup olmadığını belirleyebilirsiniz. İstemci uygulama hizmetlerini kullanacak şekilde yapılandırılmış uygulamalar için bu özellik bir ClientRolePrincipaldöndürür. Bu sınıf IPrincipal arabirimini uyguladığından, açıkça başvurmanız gerekmez. ClientRolePrincipal.IsInRole yöntemi dahili olarak ClientRoleProvider.IsUserInRole yöntemini çağırır.

ClientRoleProvider sınıfı, ServiceUri özelliği tarafından belirtilen rol hizmetinden kimliği doğrulanmış kullanıcıların rol bilgilerini alan salt okunur bir rol üyeliği sağlayıcısıdır. ServiceUri özelliğinin değeri genellikle diğer yapılandırma değerleriyle birlikte uygulama yapılandırma dosyasından alınır.

geçerli ClientRoleProvider örneğini staticRoles.Provider özelliği aracılığıyla alabilirsiniz.

ClientRoleProvider sınıfı, RoleProvider soyut sınıfının yalnızca GetRolesForUser ve IsUserInRole yöntemlerini destekler. Belirli bir kullanıcı için bu yöntemlerden birini çağırdığınızda, hizmet sağlayıcısı önce rol bilgileri için yerel veri önbelleğini denetler. Önbellek herhangi bir rol bilgisi içermiyorsa veya önbelleğin süresi dolduysa, hizmet sağlayıcısı rol hizmetinden rol bilgilerini alır ve önbelleğe ekler.

İstemci uygulama hizmetlerini yapılandırırken rol önbelleği için zaman aşımı süresini belirtebilirsiniz. GetRolesForUser yöntemini yerel önbellek yerine hizmetten rol verilerini almaya zorlamak için önce ResetCache yöntemini çağırın.

rolleri oluşturmak veya silmek ya da kullanıcıların rol üyeliğini değiştirmek için ClientRoleProvider sınıfını kullanamazsınız. Rol bilgilerini oluşturmak veya değiştirmek için sunucudaki rol hizmetinin yapılandırmasını değiştirmeniz gerekir.

Oluşturucular

ClientRoleProvider()

ClientRoleProvider sınıfının yeni bir örneğini başlatır.

Özellikler

ApplicationName

Bu özellik bu sınıf tarafından kullanılmaz.
Description

Yönetim araçlarında veya diğer kullanıcı arabirimlerinde (UI) görüntülenmeye uygun kısa ve kolay bir açıklama alır.

(Devralındığı yer: ProviderBase)
Name

Yapılandırma sırasında sağlayıcıya başvurmak için kullanılan kolay adı alır.

(Devralındığı yer: ProviderBase)
ServiceUri

Rol hizmetinin URI'sini alır veya ayarlar.

Yöntemler

AddUsersToRoles(String[], String[])

Bu yöntem bu sınıf tarafından kullanılmaz.
CreateRole(String)

Bu yöntem bu sınıf tarafından kullanılmaz.
DeleteRole(String, Boolean)

Bu yöntem bu sınıf tarafından kullanılmaz.
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
FindUsersInRole(String, String)

Bu yöntem bu sınıf tarafından kullanılmaz.
GetAllRoles()

Bu yöntem bu sınıf tarafından kullanılmaz.
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetRolesForUser(String)

Belirtilen kullanıcının ait olduğu rollerin adlarını alır.
GetType()

Geçerli örneğin Type alır.

(Devralındığı yer: Object)
GetUsersInRole(String)

Bu yöntem bu sınıf tarafından kullanılmaz.
Initialize(String, NameValueCollection)

Sağlayıcıyı başlatır.
IsUserInRole(String, String)

Belirtilen kullanıcının belirtilen rolde olup olmadığını belirten bir değer alır.
MemberwiseClone()

Geçerli Objectbasit bir kopyasını oluşturur.

(Devralındığı yer: Object)
RemoveUsersFromRoles(String[], String[])

Bu yöntem bu sınıf tarafından kullanılmaz.
ResetCache()

Önbelleğe alınan rol bilgilerini temizler ve önbellek zaman aşımı süresini sıfırlar.
RoleExists(String)

Bu yöntem bu sınıf tarafından kullanılmaz.
ToString()

Geçerli nesneyi temsil eden bir dize döndürür.

(Devralındığı yer: Object)

Şunlara uygulanır

Ayrıca bkz.