ClientRoleProvider Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.ClientServices.Providers

Bütünleştirilmiş Kod:: System.Web.Extensions.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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ı sınıfını kullanacak şekilde yapılandırarak mevcut bir rol hizmetinden rol bilgilerini almak için ClientRoleProvider istemci uygulama hizmetlerini kullanabilirsiniz. Yapılandırmadan sonra, kimliği doğrulanmış bir kullanıcının özelliği tarafından staticThread.CurrentPrincipal döndürülen yöntemini IPrincipal çağırarak IsInRole 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 arabirimini uyguladığından IPrincipal , açıkça başvurmanız gerekmez. ClientRolePrincipal.IsInRole yöntemi dahili olarak yöntemini çağırırClientRoleProvider.IsUserInRole.

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

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

sınıfı ClientRoleProvider yalnızca soyut sınıfın GetRolesForUser RoleProvider 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 roller önbelleği için zaman aşımı süresini belirtebilirsiniz. Yöntemini yerel önbellek yerine hizmetten rol verilerini almaya zorlamak GetRolesForUser için önce yöntemini çağırın ResetCache .

Rol oluşturmak veya silmek ya da kullanıcıların rol üyeliğini değiştirmek için sınıfını kullanamazsınız ClientRoleProvider . 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()	Type Geçerli örneğini 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 Objectöğesinin sığ 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 dizeyi döndürür. (Devralındığı yer: Object)

Şunlara uygulanır

Aracılığıyla paylaş