ClientFormsAuthenticationMembershipProvider Sınıf

Tanım

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 uygulama 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ı sınıfını kullanacak ClientFormsAuthenticationMembershipProvider şekilde yapılandırabilirsiniz.

Yapılandırmadan sonra, dahili olarak ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) yöntemini çağıran yöntemini çağırarak staticMembership.ValidateUser 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 yöntemine Membership.ValidateUser geçirebilirsiniz. Boş dizeler de geçirebilir veya null kimlik bilgileri sağlayıcısı kullanabilirsiniz. Kimlik bilgileri sağlayıcısı, uygulama yapılandırma dosyanızda belirtilen bir IClientFormsAuthenticationCredentialsProvider uygulamadır. Genellikle bir oturum açma iletişim kutusunu görüntülemek ve doldurulmuş ClientFormsAuthenticationCredentials bir nesne döndürmek için yöntemini uygularsınızIClientFormsAuthenticationCredentialsProvider.GetCredentials. Kimlik bilgileri sağlayıcısı kullanmak, tek bir oturum açma iletişim kutusunu birden çok uygulama arasında paylaşmanızı sağlar.

yöntemi, ClientFormsAuthenticationMembershipProvider.ValidateUser özelliği tarafından ServiceUri belirtilen oturum açma hizmeti aracılığıyla kullanıcıların kimliğini doğrular. özelliğinin ServiceUri 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ı özelliği, kullanıcı bilgilerini içeren yeni bir nesne içeren yeni ClientFormsIdentity bir nesneye ayarlarstaticThread.CurrentPrincipal.ClientRolePrincipal uygulamanız için bir ClientRoleProvider yapılandırıldıysa, rol hizmetinden ClientRolePrincipal kullanıcı rolü bilgilerini almak için nesnesini kullanabilirsiniz.

özelliği aracılığıyla staticMembership.Provider geçerli ClientFormsAuthenticationMembershipProvider örneğe başvuru alabilirsiniz. Yöntemini doğrudan çağırmak için üyelik sağlayıcısı başvuruyu ClientFormsAuthenticationMembershipProvider.ValidateUser kullanabilirsiniz. Ayrıca, temel sınıfta kullanılamayan yöntemini çağırmak Logout için üyelik sağlayıcısı başvurusuna MembershipProvider ihtiyacınız olacaktır.

Üyelik bilgilerini oluşturmak, silmek veya değiştirmek için sınıfını kullanamazsınız ClientFormsAuthenticationMembershipProvider . 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

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır

Ayrıca bkz.

• ValidateUser
• ValidateUser(String, String)
• İstemci Uygulama Servisleri
• Nasıl Yapılır: İstemci Uygulama Servislerini Yapılandırma
• Nasıl yapılır: İstemci Uygulama Hizmetleri ile Kullanıcı Oturum Açma ve Oturumu Kapatma Uygulama