ClientFormsAuthenticationMembershipProvider.ValidateUser Metod

Definition

Namnområde:: System.Web.ClientServices.Providers

Sammansättning:: System.Web.Extensions.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Autentiserar en användare med hjälp av de angivna autentiseringsuppgifterna.

Överlagringar

Name	Description
ValidateUser(String, String)	Autentiserar en användare med det angivna användarnamnet och lösenordet.
ValidateUser(String, String, Boolean)	Autentiserar en användare med det angivna användarnamnet och lösenordet, om du vill lagra en hash av lösenordet i den lokala datacachen.
ValidateUser(String, String, String)	Autentiserar en användare vid den angivna tjänst-URI:n med det angivna användarnamnet och lösenordet.

ValidateUser(String, String)

Autentiserar en användare med det angivna användarnamnet och lösenordet.

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

Parametrar

username: String

Namnet på användaren som ska autentiseras, eller Emptynull för att hämta autentiseringsuppgifter från implementeringen IClientFormsAuthenticationCredentialsProvider som programmet är konfigurerat att använda.

password: String

Lösenordet för användaren att autentisera.

Returer

Boolean

trueom användaren autentiserades. annars . false

Undantag

WebException

Egenskapsvärdet IsOffline är false och medlemskapsprovidern kan inte komma åt autentiseringstjänsten.

Exempel

Följande exempelkod visar hur du använder den här metoden för att verifiera användaren med hjälp av en IClientFormsAuthenticationCredentialsProvider implementering. Det här exemplet kräver att du konfigurerar programmet så att det använder en autentiseringsprovider.

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

Kommentarer

Formulärautentisering kräver att användaren anger sina autentiseringsuppgifter via inloggningskontroller som tillhandahålls av ditt program. Du kan hämta autentiseringsuppgifterna och skicka dem till Membership.ValidateUser metoden. Du kan också skicka in tomma strängar eller null använda en autentiseringsprovider.

Se även

Gäller för

ValidateUser(String, String, Boolean)

Autentiserar en användare med det angivna användarnamnet och lösenordet, om du vill lagra en hash av lösenordet i den lokala datacachen.

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

Parametrar

username: String

Namnet på användaren som ska autentiseras.

password: String

Lösenordet för användaren att autentisera.

rememberMe: Boolean

true för att lagra en hash av lösenordet i den lokala datacachen för offlineanvändning och för automatisk omautentisering när cookien för användarautentisering upphör att gälla. false för att inaktivera offlineinloggning eller kräva att användarna autentiserar igen när cookien upphör att gälla.

Returer

Boolean

trueom användaren autentiserades. annars . false

Undantag

WebException

Egenskapsvärdet IsOffline är false och medlemskapsprovidern kan inte komma åt autentiseringstjänsten.

Exempel

Följande exempelkod visar hur du använder den här metoden för att verifiera användaren med hjälp av inloggningskontroller i programkoden. Det här exemplet kräver en TextBox kontroll med namnet usernameTextBox, en TextBox kontroll med namnet passwordTextBoxoch en CheckBox kontroll med namnet 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

Kommentarer

Du kan använda klientprogramtjänster för att verifiera användare med hjälp av formulärautentisering. För att verifiera användare anropar staticMembership.ValidateUser du vanligtvis metoden, som internt anropar ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) metoden. Du kan också anropa ClientFormsAuthenticationMembershipProvider.ValidateUser metoden direkt. Du kan anropa den här överlagringen rememberMe för att skicka in ett username värde utöver värdena ochpassword.

Se även

Gäller för

ValidateUser(String, String, String)

Autentiserar en användare vid den angivna tjänst-URI:n med det angivna användarnamnet och lösenordet.

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

Parametrar

username: String

Namnet på användaren som ska autentiseras.

password: String

Lösenordet för användaren att autentisera.

serviceUri: String

URI:n för den autentiseringstjänst som ska användas.

Returer

Boolean

trueom användaren autentiserades. annars . false

Undantag

WebException

Egenskapsvärdet IsOffline är false och medlemskapsprovidern kan inte komma åt autentiseringstjänsten.

Exempel

Följande exempelkod visar hur du använder den här metoden för att verifiera användaren via en autentiseringstjänst på en angiven plats. Autentiseringsuppgifterna hämtas från inloggningskontrollerna i programkoden. Det här exemplet kräver en TextBox kontroll med namnet usernameTextBox och en TextBox kontroll med namnet 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

Kommentarer

Du kan använda klientprogramtjänster för att verifiera användare med hjälp av formulärautentisering. För att verifiera användare anropar staticMembership.ValidateUser du vanligtvis metoden, som internt anropar ClientFormsAuthenticationMembershipProvider.ValidateUser metoden. Du kan också anropa ClientFormsAuthenticationMembershipProvider.ValidateUser metoden direkt. Du kan anropa den här överlagringen för att få åtkomst till en autentiseringstjänst på den plats som anges av parametern serviceUri . Att använda den här överlagringen ServiceUri är ett alternativ till att ställa in egenskapen och anropa överbelastningen ValidateUser(String, String) .

Se även

Gäller för

Feedback

Var den här sidan till hjälp?