ClientFormsAuthenticationMembershipProvider.ValidateUser Metoda

Reference

Definice

Obor názvů:: System.Web.ClientServices.Providers

Sestavení:: System.Web.Extensions.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Ověřuje uživatele pomocí zadaných přihlašovacích údajů.

Přetížení

ValidateUser(String, String)	Ověřuje uživatele pomocí zadaného uživatelského jména a hesla.
ValidateUser(String, String, Boolean)	Ověřuje uživatele pomocí zadaného uživatelského jména a hesla a volitelně uloží hodnotu hash hesla do místní mezipaměti dat.
ValidateUser(String, String, String)	Ověří uživatele na zadaném identifikátoru URI služby pomocí zadaného uživatelského jména a hesla.

ValidateUser(String, String)

Ověřuje uživatele pomocí zadaného uživatelského jména a hesla.

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

Parametry

username: String

Jméno uživatele, který se má ověřit, nebo Emptynull načíst přihlašovací údaje z IClientFormsAuthenticationCredentialsProvider implementace, pro kterou je tato aplikace nakonfigurovaná.

password: String

Heslo uživatele, který se má ověřit.

Návraty

Boolean

truepokud byl uživatel ověřen; v opačném případě . false

Výjimky

WebException

Hodnota IsOffline vlastnosti je false a zprostředkovatel členství nemá přístup k ověřovací službě.

Příklady

Následující příklad kódu ukazuje, jak použít tuto metodu k ověření uživatele pomocí IClientFormsAuthenticationCredentialsProvider implementace. Tento příklad vyžaduje, abyste aplikaci nakonfigurovali tak, aby používala zprostředkovatele přihlašovacích údajů.

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

Poznámky

Ověřování pomocí formulářů vyžaduje, aby uživatel zadal své přihlašovací údaje prostřednictvím ovládacích prvků pro přihlášení poskytovaných vaší aplikací. Přihlašovací údaje můžete načíst a předat je metodě Membership.ValidateUser . Můžete také předat prázdné řetězce nebo null použít poskytovatele přihlašovacích údajů.

Viz také

Platí pro

ValidateUser(String, String, Boolean)

Ověřuje uživatele pomocí zadaného uživatelského jména a hesla a volitelně uloží hodnotu hash hesla do místní mezipaměti dat.

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

Parametry

username: String

Jméno uživatele, který se má ověřit.

password: String

Heslo uživatele, který se má ověřit.

rememberMe: Boolean

true uložení hodnoty hash hesla v místní mezipaměti dat pro použití offline a pro automatické opětovné ověření, když vyprší platnost souboru cookie pro ověření uživatele; false pokud chcete zakázat offline přihlášení nebo vyžadovat, aby se uživatelé po vypršení platnosti souboru cookie znovu přihlásili.

Návraty

Boolean

truepokud byl uživatel ověřen; v opačném případě . false

Výjimky

WebException

Hodnota IsOffline vlastnosti je false a zprostředkovatel členství nemá přístup k ověřovací službě.

Příklady

Následující příklad kódu ukazuje, jak použít tuto metodu k ověření uživatele pomocí ovládacích prvků přihlášení v kódu aplikace. Tento příklad vyžaduje TextBox ovládací prvek s názvem usernameTextBox, TextBox ovládací prvek s názvem passwordTextBoxa CheckBox ovládací prvek s názvem rememberMeCheckBox.

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

Poznámky

Služby klientských aplikací můžete použít k ověřování uživatelů pomocí ověřování pomocí formulářů. K ověření uživatelů obvykle voláte metodu , staticMembership.ValidateUser která interně volá metodu ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) . Alternativně můžete volat metodu ClientFormsAuthenticationMembershipProvider.ValidateUser přímo. Voláním tohoto přetížení můžete předat rememberMe kromě hodnot a password také hodnotuusername.

Viz také

Platí pro

ValidateUser(String, String, String)

Ověří uživatele na zadaném identifikátoru URI služby pomocí zadaného uživatelského jména a hesla.

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

Parametry

username: String

Jméno uživatele, který se má ověřit.

password: String

Heslo uživatele, který se má ověřit.

serviceUri: String

Identifikátor URI ověřovací služby, která se má použít.

Návraty

Boolean

truepokud byl uživatel ověřen; v opačném případě . false

Výjimky

WebException

Hodnota IsOffline vlastnosti je false a zprostředkovatel členství nemá přístup k ověřovací službě.

Příklady

Následující příklad kódu ukazuje, jak použít tuto metodu k ověření uživatele prostřednictvím ověřovací služby v zadaném umístění. Přihlašovací údaje uživatele se načítají z přihlašovacích ovládacích prvků v kódu aplikace. Tento příklad vyžaduje TextBox ovládací prvek s názvem usernameTextBox a TextBox ovládací prvek s názvem passwordTextBox.

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

Poznámky

Služby klientských aplikací můžete použít k ověřování uživatelů pomocí ověřování pomocí formulářů. K ověření uživatelů obvykle voláte metodu , staticMembership.ValidateUser která interně volá metodu ClientFormsAuthenticationMembershipProvider.ValidateUser . Alternativně můžete volat metodu ClientFormsAuthenticationMembershipProvider.ValidateUser přímo. Toto přetížení můžete volat pro přístup k ověřovací službě v umístění určeném parametrem serviceUri . Použití tohoto přetížení je alternativou k nastavení ServiceUri vlastnosti a volání ValidateUser(String, String) přetížení.

Viz také

Platí pro

Sdílet prostřednictvím

ClientFormsAuthenticationMembershipProvider.ValidateUser Metoda

Definice

Přetížení

ValidateUser(String, String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

ValidateUser(String, String, Boolean)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

ValidateUser(String, String, String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Váš názor

Další materiály