ClientFormsAuthenticationMembershipProvider.ValidateUser Metoda

Definicja

Przestrzeń nazw:

System.Web.ClientServices.Providers

Zestaw:

System.Web.Extensions.dll

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 Empty lub null pobierania poświadczeń z implementacji IClientFormsAuthenticationCredentialsProvider, która jest skonfigurowana do użycia przez tę aplikację.

password

String

Hasło użytkownika do uwierzytelnienia.

Zwraca

Boolean

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

Wyjątki

WebException

Wartość właściwości IsOffline jest false, a 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 należy skonfigurować aplikację 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

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ć tę metodę bezpośrednio, jak pokazano w sekcji Przykład.

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

Zobacz też

• IClientFormsAuthenticationCredentialsProvider
• ValidateUser(String, String)
• usług aplikacji klienckich
• Instrukcje: konfigurowanie usług aplikacji klienckich
• Instrukcje: implementowanie logowania użytkownika i wylogowywanie przy użyciu usług aplikacji klienckich

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 uwierzytelnienia.

rememberMe

Boolean

true do przechowywania skrótu hasła w lokalnej pamięci podręcznej danych do użytku w trybie offline i automatycznego ponownego uwierzytelniania po wygaśnięciu pliku cookie uwierzytelniania użytkownika; false 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ść właściwości IsOffline jest false, a 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. W tym przykładzie jest wymagana kontrolka TextBox o nazwie usernameTextBox, kontrolka TextBox o nazwie passwordTextBoxi kontrolka 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 bezpośrednio wywołać metodę ClientFormsAuthenticationMembershipProvider.ValidateUser. To przeciążenie można wywołać, aby przekazać wartość rememberMe oprócz wartości username i password.

Zobacz też

• ValidateUser(String, String)
• usług aplikacji klienckich
• Instrukcje: konfigurowanie usług aplikacji klienckich
• Instrukcje: implementowanie logowania użytkownika i wylogowywanie przy użyciu usług aplikacji klienckich

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 uwierzytelnienia.

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ść właściwości IsOffline jest false, a 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. W tym przykładzie wymagana jest kontrolka TextBox o nazwie usernameTextBox i kontrolka 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 bezpośrednio wywołać metodę ClientFormsAuthenticationMembershipProvider.ValidateUser. To przeciążenie można wywołać, aby uzyskać dostęp do usługi uwierzytelniania w lokalizacji określonej przez parametr serviceUri. Użycie tego przeciążenia jest alternatywą dla ustawienia właściwości ServiceUri i wywoływania przeciążenia ValidateUser(String, String).

Zobacz też

• ValidateUser(String, String)
• usług aplikacji klienckich
• Instrukcje: konfigurowanie usług aplikacji klienckich
• Instrukcje: implementowanie logowania użytkownika i wylogowywanie przy użyciu usług aplikacji klienckich