ClientFormsAuthenticationMembershipProvider 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.

İstemci uygulama hizmetleriyle form kimlik doğrulamasını etkinleştirir.

public ref class ClientFormsAuthenticationMembershipProvider : System::Web::Security::MembershipProvider

public class ClientFormsAuthenticationMembershipProvider : System.Web.Security.MembershipProvider

type ClientFormsAuthenticationMembershipProvider = class
    inherit MembershipProvider

Public Class ClientFormsAuthenticationMembershipProvider
Inherits MembershipProvider

Devralma: Object

ProviderBase

MembershipProvider
ClientFormsAuthenticationMembershipProvider

Örnekler

Aşağıdaki örnek kod, bir IClientFormsAuthenticationCredentialsProvider uygulaması kullanarak kullanıcıyı doğrulamak için bu yöntemin nasıl kullanılacağını gösterir.

private bool ValidateUsingCredentialsProvider()
{
    bool isAuthorized = false;
    try
    {
        ClientFormsAuthenticationMembershipProvider authProvider =
            System.Web.Security.Membership.Provider as
            ClientFormsAuthenticationMembershipProvider;

        // Call ValidateUser with empty strings in order to display the 
        // login dialog box configured as a credentials provider.
        isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty);
    }
    catch (System.Net.WebException)
    {
        MessageBox.Show("Unable to access the authentication service.",
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
    }
    if (!isAuthorized)
    {
        MessageBox.Show("Unable to authenticate.", "Not logged in", 
            MessageBoxButtons.OK, MessageBoxIcon.Error);
        Application.Exit();
    }
    return isAuthorized;
}

Private Function ValidateUsingCredentialsProvider() As Boolean

    Dim isAuthorized As Boolean = False

    Try

        Dim authProvider As ClientFormsAuthenticationMembershipProvider = _
            CType(System.Web.Security.Membership.Provider,  _
            ClientFormsAuthenticationMembershipProvider)

        ' Call ValidateUser with empty strings in order to display the 
        ' login dialog box configured as a credentials provider.
        isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty)

    Catch ex As System.Net.WebException

        MessageBox.Show("Unable to access the authentication service.", _
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)

    End Try

    If Not isAuthorized Then

        MessageBox.Show("Unable to authenticate.", "Not logged in", _
            MessageBoxButtons.OK, MessageBoxIcon.Error)
        Application.Exit()

    End If

    Return isAuthorized

End Function

Açıklamalar

Form kimlik doğrulamasını kullanarak kullanıcıları doğrulamak için istemci uygulama hizmetlerini kullanabilirsiniz. Form kimlik doğrulamasını etkinleştirmek için uygulamanızı ClientFormsAuthenticationMembershipProvider sınıfını kullanacak şekilde yapılandırabilirsiniz.

Yapılandırmadan sonra, dahili olarak ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) yöntemini çağıran staticMembership.ValidateUser yöntemini çağırarak kullanıcıları doğrulayabilirsiniz.

Forms kimlik doğrulaması, kullanıcının kimlik bilgilerini uygulamanız tarafından sağlanan oturum açma denetimleri aracılığıyla belirtmesini gerektirir. Kimlik bilgilerini alabilir ve Membership.ValidateUser yöntemine geçirebilirsiniz. Ayrıca, kimlik bilgileri sağlayıcısını kullanmak için boş dizeler veya null geçirebilirsiniz. Kimlik bilgileri sağlayıcısı, uygulama yapılandırma dosyanızda belirtilen IClientFormsAuthenticationCredentialsProvider bir uygulamadır. Genellikle oturum açma iletişim kutusunu görüntülemek ve doldurulmuş bir ClientFormsAuthenticationCredentials nesnesi döndürmek için IClientFormsAuthenticationCredentialsProvider.GetCredentials yöntemini uygularsınız. Kimlik bilgisi sağlayıcısı kullanmak, tek bir oturum açma iletişim kutusunu birden çok uygulama arasında paylaşmanızı sağlar.

ClientFormsAuthenticationMembershipProvider.ValidateUser yöntemi, ServiceUri özelliği tarafından belirtilen oturum açma hizmeti aracılığıyla kullanıcıların kimliğini doğrular. ServiceUri özelliğinin değeri genellikle diğer yapılandırma değerleriyle birlikte uygulama yapılandırma dosyasından alınır.

Kullanıcının kimliği başarıyla doğrulanırsa, hizmet sağlayıcısı staticThread.CurrentPrincipal özelliğini kullanıcı bilgilerini içeren yeni bir ClientFormsIdentity nesnesi içeren yeni bir ClientRolePrincipal nesnesine ayarlar. Uygulamanız için bir ClientRoleProvider yapılandırıldıysa, rol hizmetinden kullanıcı rolü bilgilerini almak için ClientRolePrincipal nesnesini kullanabilirsiniz.

static Membership.Provider özelliği aracılığıyla geçerli ClientFormsAuthenticationMembershipProvider örneğine başvuru alabilirsiniz. ClientFormsAuthenticationMembershipProvider.ValidateUser yöntemini doğrudan çağırmak için üyelik sağlayıcısı başvuruyu kullanabilirsiniz. Ayrıca, MembershipProvider temel sınıfında bulunmayan Logout yöntemini çağırmak için üyelik sağlayıcısı başvurusuna ihtiyacınız olacaktır.

üyelik bilgilerini oluşturmak, silmek veya değiştirmek için ClientFormsAuthenticationMembershipProvider sınıfını kullanamazsınız. Kullanıcıları oluşturmak, silmek veya değiştirmek için sunucudaki oturum açma hizmetinin yapılandırmasını değiştirmeniz gerekir.

Oluşturucular

ClientFormsAuthenticationMembershipProvider()

ClientFormsAuthenticationMembershipProvider 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)
EnablePasswordReset	Bu özellik bu sınıf tarafından kullanılmaz.
EnablePasswordRetrieval	Bu özellik bu sınıf tarafından kullanılmaz.
MaxInvalidPasswordAttempts	Bu özellik bu sınıf tarafından kullanılmaz.
MinRequiredNonAlphanumericCharacters	Bu özellik bu sınıf tarafından kullanılmaz.
MinRequiredPasswordLength	Bu özellik bu sınıf tarafından kullanılmaz.
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)
PasswordAttemptWindow	Bu özellik bu sınıf tarafından kullanılmaz.
PasswordFormat	Bu özellik bu sınıf tarafından kullanılmaz.
PasswordStrengthRegularExpression	Bu özellik bu sınıf tarafından kullanılmaz.
RequiresQuestionAndAnswer	Bu özellik bu sınıf tarafından kullanılmaz.
RequiresUniqueEmail	Bu özellik bu sınıf tarafından kullanılmaz.
ServiceUri	Kimlik doğrulama hizmetinin URI'sini alır veya ayarlar.

Yöntemler

ChangePassword(String, String, String)	Bu yöntem bu sınıf tarafından kullanılmaz.
ChangePasswordQuestionAndAnswer(String, String, String, String)	Bu yöntem bu sınıf tarafından kullanılmaz.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	Bu yöntem bu sınıf tarafından kullanılmaz.
DecryptPassword(Byte[])	Şifrelenmiş parolanın şifresini çözer. (Devralındığı yer: MembershipProvider)
DeleteUser(String, Boolean)	Bu yöntem bu sınıf tarafından kullanılmaz.
EncryptPassword(Byte[])	Parolayı şifreler. (Devralındığı yer: MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	Belirtilen parolayı belirtilen parola uyumluluk modunu kullanarak şifreler. (Devralındığı yer: MembershipProvider)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
FindUsersByEmail(String, Int32, Int32, Int32)	Bu yöntem bu sınıf tarafından kullanılmaz.
FindUsersByName(String, Int32, Int32, Int32)	Bu yöntem bu sınıf tarafından kullanılmaz.
GetAllUsers(Int32, Int32, Int32)	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)
GetNumberOfUsersOnline()	Bu yöntem bu sınıf tarafından kullanılmaz.
GetPassword(String, String)	Bu yöntem bu sınıf tarafından kullanılmaz.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
GetUser(Object, Boolean)	Bu yöntem bu sınıf tarafından kullanılmaz.
GetUser(String, Boolean)	Bu yöntem bu sınıf tarafından kullanılmaz.
GetUserNameByEmail(String)	Bu yöntem bu sınıf tarafından kullanılmaz.
Initialize(String, NameValueCollection)	Sağlayıcıyı başlatır.
Logout()	Kullanıcının oturumunu kapatın.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
OnValidatingPassword(ValidatePasswordEventArgs)	Bir olay işleyicisi tanımlanmışsa ValidatingPassword olayını tetikler. (Devralındığı yer: MembershipProvider)
ResetPassword(String, 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)
UnlockUser(String)	Bu yöntem bu sınıf tarafından kullanılmaz.
UpdateUser(MembershipUser)	Bu yöntem bu sınıf tarafından kullanılmaz.
ValidateUser(String, String)	Belirtilen kullanıcı adını ve parolayı kullanarak kullanıcının kimliğini doğrular.
ValidateUser(String, String, Boolean)	Belirtilen kullanıcı adını ve parolayı kullanarak kullanıcının kimliğini doğrular ve isteğe bağlı olarak parolanın karması yerel veri önbelleğinde depolanır.
ValidateUser(String, String, String)	Belirtilen kullanıcı adı ve parolayı kullanarak belirtilen hizmet URI'sinde bir kullanıcının kimliğini doğrular.

Ekinlikler

UserValidated	Kullanıcı doğrulandığında gerçekleşir.
ValidatingPassword	Kullanıcı oluşturulduğunda, parola değiştirildiğinde veya parola sıfırlandığında gerçekleşir. (Devralındığı yer: MembershipProvider)

Şunlara uygulanır

Aracılığıyla paylaş