ClientFormsAuthenticationMembershipProvider.ValidateUser Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.ClientServices.Providers

Zestaw:: System.Web.Extensions.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Uwierzytelnia użytkownika przy użyciu określonych poświadczeń.

Przeciążenia

ValidateUser(String, String)	Uwierzytelnia użytkownika przy użyciu określonej nazwy użytkownika i hasła.
ValidateUser(String, String, Boolean)	Uwierzytelnia użytkownika przy użyciu określonej nazwy użytkownika i hasła, opcjonalnie przechowując skrót hasła w lokalnej pamięci podręcznej danych.
ValidateUser(String, String, String)	Uwierzytelnia użytkownika w określonym identyfikatorze URI usługi przy użyciu określonej nazwy użytkownika i hasła.

ValidateUser(String, String)

Uwierzytelnia użytkownika przy użyciu określonej nazwy użytkownika i hasła.

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

Nazwa użytkownika do uwierzytelniania lub Emptynull pobierania poświadczeń z implementacji skonfigurowanej IClientFormsAuthenticationCredentialsProvider do użycia przez tę aplikację.

password: String

Hasło użytkownika do uwierzytelniania.

Zwraca

Boolean

true jeśli użytkownik został uwierzytelniony; w przeciwnym razie , false.

Wyjątki

WebException

Wartość IsOffline właściwości to false i dostawca członkostwa nie może uzyskać dostępu do usługi uwierzytelniania.

Przykłady

Poniższy przykładowy kod pokazuje, jak używać tej metody do weryfikowania użytkownika przy użyciu implementacji IClientFormsAuthenticationCredentialsProvider . W tym przykładzie wymagane jest skonfigurowanie aplikacji do używania dostawcy poświadczeń.

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

Uwagi

Uwierzytelnianie formularzy wymaga, aby użytkownik określił swoje poświadczenia za pomocą kontrolek logowania dostarczonych przez aplikację. Możesz pobrać poświadczenia i przekazać je do Membership.ValidateUser metody . Możesz również przekazać puste ciągi lub null użyć dostawcy poświadczeń.

Zobacz też

Dotyczy

ValidateUser(String, String, Boolean)

Uwierzytelnia użytkownika przy użyciu określonej nazwy użytkownika i hasła, opcjonalnie przechowując skrót hasła w lokalnej pamięci podręcznej danych.

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

Nazwa użytkownika do uwierzytelnienia.

password: String

Hasło użytkownika do uwierzytelniania.

rememberMe: Boolean

true do przechowywania skrótu hasła w lokalnej pamięci podręcznej danych do użycia w trybie offline i automatycznego ponownego uwierzytelniania po wygaśnięciu pliku cookie uwierzytelniania użytkownika; false aby wyłączyć logowanie w trybie offline lub wymagać od użytkowników ponownego uwierzytelnienia po wygaśnięciu pliku cookie.

Zwraca

Boolean

true jeśli użytkownik został uwierzytelniony; w przeciwnym razie , false.

Wyjątki

WebException

Wartość IsOffline właściwości to false i dostawca członkostwa nie może uzyskać dostępu do usługi uwierzytelniania.

Przykłady

Poniższy przykładowy kod pokazuje, jak używać tej metody do weryfikowania użytkownika przy użyciu kontrolek logowania w kodzie aplikacji. Ten przykład wymaga kontrolki TextBox o nazwie usernameTextBox, TextBox kontrolce o nazwie passwordTextBoxi kontrolce CheckBox o nazwie 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

Uwagi

Usługi aplikacji klienckich umożliwiają weryfikowanie użytkowników przy użyciu uwierzytelniania formularzy. Aby zweryfikować użytkowników, zazwyczaj wywołasz metodę staticMembership.ValidateUser , która wewnętrznie wywołuje metodę ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) . Alternatywnie można wywołać metodę ClientFormsAuthenticationMembershipProvider.ValidateUser bezpośrednio. To przeciążenie można wywołać, aby przekazać rememberMe wartość oprócz username wartości i password .

Zobacz też

Dotyczy

ValidateUser(String, String, String)

Uwierzytelnia użytkownika w określonym identyfikatorze URI usługi przy użyciu określonej nazwy użytkownika i hasła.

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

Nazwa użytkownika do uwierzytelnienia.

password: String

Hasło użytkownika do uwierzytelniania.

serviceUri: String

Identyfikator URI usługi uwierzytelniania do użycia.

Zwraca

Boolean

true jeśli użytkownik został uwierzytelniony; w przeciwnym razie , false.

Wyjątki

WebException

Wartość IsOffline właściwości to false i dostawca członkostwa nie może uzyskać dostępu do usługi uwierzytelniania.

Przykłady

Poniższy przykładowy kod pokazuje, jak używać tej metody do weryfikowania użytkownika za pośrednictwem usługi uwierzytelniania w określonej lokalizacji. Poświadczenia użytkownika są pobierane z kontrolek logowania w kodzie aplikacji. Ten przykład wymaga kontrolki TextBox o nazwie usernameTextBox i kontrolce TextBox o nazwie 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

Uwagi

Usługi aplikacji klienckich umożliwiają weryfikowanie użytkowników przy użyciu uwierzytelniania formularzy. Aby zweryfikować użytkowników, zazwyczaj wywołasz metodę staticMembership.ValidateUser , która wewnętrznie wywołuje metodę ClientFormsAuthenticationMembershipProvider.ValidateUser . Alternatywnie można wywołać metodę ClientFormsAuthenticationMembershipProvider.ValidateUser bezpośrednio. To przeciążenie można wywołać, aby uzyskać dostęp do usługi uwierzytelniania w lokalizacji określonej przez serviceUri parametr . Użycie tego przeciążenia jest alternatywą dla ustawienia ServiceUri właściwości i wywołania ValidateUser(String, String) przeciążenia.

Zobacz też

Dotyczy

Udostępnij przez

ClientFormsAuthenticationMembershipProvider.ValidateUser Metoda

Definicja

Przeciążenia

ValidateUser(String, String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

ValidateUser(String, String, Boolean)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

ValidateUser(String, String, String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Opinia

Dodatkowe zasoby