ClientFormsAuthenticationMembershipProvider.ValidateUser Yöntem

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.

Belirtilen kimlik bilgilerini kullanarak kullanıcının kimliğini doğrular.

Aşırı Yüklemeler

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.

ValidateUser(String, String)

Belirtilen kullanıcı adını ve parolayı kullanarak kullanıcının kimliğini doğrular.

public:
 override bool ValidateUser(System::String ^ username, System::String ^ password);

public override bool ValidateUser (string username, string password);

override this.ValidateUser : string * string -> bool

Public Overrides Function ValidateUser (username As String, password As String) As Boolean

Parametreler

username: String

Kimlik doğrulaması için kullanıcının adı veya bu uygulamanın kullanmak üzere yapılandırıldığı IClientFormsAuthenticationCredentialsProvider uygulamasından kimlik bilgilerini almak için Empty veya null.

password: String

Kimlik doğrulaması için kullanıcının parolası.

Döndürülenler

Boolean

Kullanıcının kimliğinin doğrulanmış olup olmadığını true; aksi takdirde false.

Özel durumlar

WebException

IsOffline özellik değeri false ve üyelik sağlayıcısı kimlik doğrulama hizmetine erişemiyor.

Ö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. Bu örnek, uygulamanızı bir kimlik bilgisi sağlayıcısı kullanacak şekilde yapılandırmanızı gerektirir.

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

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.

Ayrıca bkz.

Şunlara uygulanır

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.

public:
 bool ValidateUser(System::String ^ username, System::String ^ password, bool rememberMe);

public bool ValidateUser (string username, string password, bool rememberMe);

override this.ValidateUser : string * string * bool -> bool

Public Function ValidateUser (username As String, password As String, rememberMe As Boolean) As Boolean

Parametreler

username: String

Kimlik doğrulaması için kullanıcının adı.

password: String

Kimlik doğrulaması için kullanıcının parolası.

rememberMe: Boolean

Çevrimdışı kullanım için ve kullanıcı kimlik doğrulaması tanımlama bilgisinin süresi dolduğunda otomatik yeniden kimlik doğrulaması için yerel veri önbelleğinde parola karması depolamak true; Çevrimdışı oturum açmayı devre dışı bırakmak veya tanımlama bilgisinin süresi dolduğunda kullanıcıların yeniden kimlik doğrulamasını zorunlu kılmayı false.

Döndürülenler

Boolean

Kullanıcının kimliğinin doğrulanmış olup olmadığını true; aksi takdirde false.

Özel durumlar

WebException

IsOffline özellik değeri false ve üyelik sağlayıcısı kimlik doğrulama hizmetine erişemiyor.

Örnekler

Aşağıdaki örnek kod, uygulama kodunuzda oturum açma denetimlerini kullanarak kullanıcıyı doğrulamak için bu yöntemin nasıl kullanılacağını gösterir. Bu örnekte usernameTextBoxadlı bir TextBox denetimi, passwordTextBoxadlı bir TextBox denetimi ve rememberMeCheckBoxadlı bir CheckBox denetimi gerekir.

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

        // Call ValidateUser with credentials retrieved from login controls.
        isAuthorized = authProvider.ValidateUser(usernameTextBox.Text,
            passwordTextBox.Text, rememberMeCheckBox.Checked);
    }
    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 ValidateUsingLoginControls() As Boolean

    Dim isAuthorized As Boolean = False

    Try

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

        ' Call ValidateUser with credentials retrieved from login controls.
        isAuthorized = authProvider.ValidateUser(usernameTextBox.Text, _
            passwordTextBox.Text, rememberMeCheckBox.Checked)

    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. Kullanıcıları doğrulamak için genellikle dahili olarak ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) yöntemini çağıran staticMembership.ValidateUser yöntemini çağırırsınız. Alternatif olarak, ClientFormsAuthenticationMembershipProvider.ValidateUser yöntemini doğrudan çağırabilirsiniz. username ve password değerlerine ek olarak bir rememberMe değeri geçirmek için bu aşırı yüklemeyi çağırabilirsiniz.

Ayrıca bkz.

Şunlara uygulanı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.

public:
 static bool ValidateUser(System::String ^ username, System::String ^ password, System::String ^ serviceUri);

public static bool ValidateUser (string username, string password, string serviceUri);

static member ValidateUser : string * string * string -> bool

Public Shared Function ValidateUser (username As String, password As String, serviceUri As String) As Boolean

Parametreler

username: String

Kimlik doğrulaması için kullanıcının adı.

password: String

Kimlik doğrulaması için kullanıcının parolası.

serviceUri: String

Kullanılacak kimlik doğrulama hizmetinin URI'sini.

Döndürülenler

Boolean

Kullanıcının kimliğinin doğrulanmış olup olmadığını true; aksi takdirde false.

Özel durumlar

WebException

IsOffline özellik değeri false ve üyelik sağlayıcısı kimlik doğrulama hizmetine erişemiyor.

Örnekler

Aşağıdaki örnek kod, kullanıcıyı belirli bir konumdaki bir kimlik doğrulama hizmeti aracılığıyla doğrulamak için bu yöntemin nasıl kullanılacağını gösterir. Kullanıcı kimlik bilgileri uygulama kodunuzdaki oturum açma denetimlerinden alınır. Bu örnekte, usernameTextBox adlı bir TextBox denetimi ve passwordTextBoxadlı bir TextBox denetimi gerekir.

private bool ValidateUsingServiceUri(String serviceUri)
{
    bool isAuthorized = false;
    try
    {
        // Call the static overload of ValidateUser. Specify credentials 
        // retrieved from login controls and the service location.
        isAuthorized = 
            ClientFormsAuthenticationMembershipProvider.ValidateUser(
            usernameTextBox.Text, passwordTextBox.Text, serviceUri);
    }
    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 ValidateUsingServiceUri(ByVal serviceUri As String) As Boolean

    Dim isAuthorized As Boolean = False

    Try

        ' Call the Shared overload of ValidateUser. Specify credentials 
        ' retrieved from login controls and the service location.
        isAuthorized = _
            ClientFormsAuthenticationMembershipProvider.ValidateUser( _
            usernameTextBox.Text, passwordTextBox.Text, serviceUri)

    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. Kullanıcıları doğrulamak için genellikle dahili olarak ClientFormsAuthenticationMembershipProvider.ValidateUser yöntemini çağıran staticMembership.ValidateUser yöntemini çağırırsınız. Alternatif olarak, ClientFormsAuthenticationMembershipProvider.ValidateUser yöntemini doğrudan çağırabilirsiniz. serviceUri parametresi tarafından belirtilen konumdaki bir kimlik doğrulama hizmetine erişmek için bu aşırı yüklemeyi çağırabilirsiniz. Bu aşırı yüklemenin kullanılması, ServiceUri özelliğini ayarlamaya ve ValidateUser(String, String) aşırı yüklemesini çağırmaya alternatiftir.

Ayrıca bkz.

Şunlara uygulanır

Aracılığıyla paylaş

ClientFormsAuthenticationMembershipProvider.ValidateUser Yöntem

Tanım

Aşırı Yüklemeler

ValidateUser(String, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

ValidateUser(String, String, Boolean)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

ValidateUser(String, String, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Ek kaynaklar