ClientFormsAuthenticationMembershipProvider.ValidateUser Metoda

Definice

Obor názvů:

System.Web.ClientServices.Providers

Sestavení:

System.Web.Extensions.dll

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, volitelně uloží hodnotu hash hesla do místní mezipaměti dat.
ValidateUser(String, String, String)	Ověřuje 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 Empty nebo null k načtení přihlašovacích údajů z implementace IClientFormsAuthenticationCredentialsProvider, kterou má tato aplikace používat.

password

String

Heslo uživatele k ověření.

Návraty

Boolean

true, pokud byl uživatel ověřen; jinak false.

Výjimky

WebException

Hodnota vlastnosti IsOffline je false a zprostředkovatel členství nemůže získat přístup ke službě ověřování.

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

Pomocí klientských aplikačních služeb můžete ověřovat uživatele pomocí ověřování pomocí formulářů. K ověření uživatelů obvykle zavoláte metodu staticMembership.ValidateUser, která interně volá metodu ClientFormsAuthenticationMembershipProvider.ValidateUser. Alternativně můžete tuto metodu volat přímo, jak je znázorněno v části Příklad.

Ověřování pomocí formulářů vyžaduje, aby uživatel zadal své přihlašovací údaje prostřednictvím přihlašovacích ovládacích prvků 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 zprostředkovatele přihlašovacích údajů.

Viz také

• IClientFormsAuthenticationCredentialsProvider
• ValidateUser(String, String)
• klientských aplikačních služeb
• Postupy: Konfigurace klientských aplikačních služeb
• Postupy: Implementace přihlášení uživatele a odhlášení pomocí klientských aplikačních služeb

ValidateUser(String, String, Boolean)

Ověřuje uživatele pomocí zadaného uživatelského jména a hesla, 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 k ověření.

rememberMe

Boolean

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

Návraty

Boolean

true, pokud byl uživatel ověřen; jinak false.

Výjimky

WebException

Hodnota vlastnosti IsOffline je false a zprostředkovatel členství nemůže získat přístup ke službě ověřování.

Příklady

Následující příklad kódu ukazuje, jak použít tuto metodu k ověření uživatele pomocí přihlašovacích ovládacích prvků v kódu aplikace. Tento příklad vyžaduje ovládací prvek TextBox s názvem usernameTextBox, ovládací prvek TextBox s názvem passwordTextBoxa ovládací prvek CheckBox 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

Pomocí klientských aplikačních služeb můžete ověřovat uživatele pomocí ověřování pomocí formulářů. K ověření uživatelů obvykle zavoláte metodu staticMembership.ValidateUser, která interně volá metodu ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String). Alternativně můžete metodu ClientFormsAuthenticationMembershipProvider.ValidateUser volat přímo. Toto přetížení můžete volat tak, aby předávala hodnotu rememberMe kromě hodnot username a password.

Viz také

• ValidateUser(String, String)
• klientských aplikačních služeb
• Postupy: Konfigurace klientských aplikačních služeb
• Postupy: Implementace přihlášení uživatele a odhlášení pomocí klientských aplikačních služeb

ValidateUser(String, String, String)

Ověřuje 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 k ověření.

serviceUri

String

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

Návraty

Boolean

true, pokud byl uživatel ověřen; jinak false.

Výjimky

WebException

Hodnota vlastnosti IsOffline je false a zprostředkovatel členství nemůže získat přístup ke službě ověřování.

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 ovládací prvek TextBox s názvem usernameTextBox a ovládací prvek TextBox 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

Pomocí klientských aplikačních služeb můžete ověřovat uživatele pomocí ověřování pomocí formulářů. K ověření uživatelů obvykle zavoláte metodu staticMembership.ValidateUser, která interně volá metodu ClientFormsAuthenticationMembershipProvider.ValidateUser. Alternativně můžete metodu ClientFormsAuthenticationMembershipProvider.ValidateUser volat 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í vlastnosti ServiceUri a volání ValidateUser(String, String) přetížení.

Viz také

• ValidateUser(String, String)
• klientských aplikačních služeb
• Postupy: Konfigurace klientských aplikačních služeb
• Postupy: Implementace přihlášení uživatele a odhlášení pomocí klientských aplikačních služeb