ClientFormsAuthenticationMembershipProvider.ValidateUser Metode

Referensi

Definisi

Ruang nama:: System.Web.ClientServices.Providers

Rakitan:: System.Web.Extensions.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengautentikasi pengguna dengan menggunakan kredensial yang ditentukan.

Overload

ValidateUser(String, String)	Mengautentikasi pengguna dengan menggunakan nama pengguna dan kata sandi yang ditentukan.
ValidateUser(String, String, Boolean)	Mengautentikasi pengguna dengan menggunakan nama pengguna dan kata sandi yang ditentukan, secara opsional menyimpan hash kata sandi di cache data lokal.
ValidateUser(String, String, String)	Mengautentikasi pengguna di URI layanan yang ditentukan dengan menggunakan nama pengguna dan kata sandi yang ditentukan.

ValidateUser(String, String)

Mengautentikasi pengguna dengan menggunakan nama pengguna dan kata sandi yang ditentukan.

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

Parameter

username: String

Nama pengguna untuk mengautentikasi, atau Empty atau null untuk mengambil kredensial dari implementasi IClientFormsAuthenticationCredentialsProvider yang dikonfigurasi untuk digunakan aplikasi ini.

password: String

Kata sandi pengguna untuk mengautentikasi.

Mengembalikan

Boolean

true jika pengguna diautentikasi; jika tidak, false.

Pengecualian

WebException

Nilai properti IsOfflinefalse dan penyedia keanggotaan tidak dapat mengakses layanan autentikasi.

Contoh

Contoh kode berikut menunjukkan cara menggunakan metode ini untuk memvalidasi pengguna dengan menggunakan implementasi IClientFormsAuthenticationCredentialsProvider. Contoh ini mengharuskan Anda mengonfigurasi aplikasi untuk menggunakan penyedia kredensial.

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

Keterangan

Autentikasi formulir mengharuskan pengguna menentukan kredensial mereka melalui kontrol masuk yang disediakan oleh aplikasi Anda. Anda dapat mengambil kredensial dan meneruskannya ke metode Membership.ValidateUser. Anda juga dapat meneruskan string kosong atau null untuk menggunakan penyedia info masuk.

Lihat juga

IClientFormsAuthenticationCredentialsProvider
ValidateUser(String, String)
Client Application Services
Cara: Mengonfigurasi Layanan Aplikasi Klien
Cara: Menerapkan Login dan Keluar Pengguna dengan Layanan Aplikasi Klien

Berlaku untuk

ValidateUser(String, String, Boolean)

Mengautentikasi pengguna dengan menggunakan nama pengguna dan kata sandi yang ditentukan, secara opsional menyimpan hash kata sandi di cache data lokal.

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

Parameter

username: String

Nama pengguna yang akan diautentikasi.

password: String

Kata sandi pengguna untuk mengautentikasi.

rememberMe: Boolean

true menyimpan hash kata sandi di cache data lokal untuk penggunaan offline dan untuk autentikasi ulang otomatis saat cookie autentikasi pengguna kedaluwarsa; false untuk menonaktifkan masuk offline atau mengharuskan pengguna untuk mengaauthentikasi ulang saat cookie kedaluwarsa.

Mengembalikan

Boolean

true jika pengguna diautentikasi; jika tidak, false.

Pengecualian

WebException

Nilai properti IsOfflinefalse dan penyedia keanggotaan tidak dapat mengakses layanan autentikasi.

Contoh

Contoh kode berikut menunjukkan cara menggunakan metode ini untuk memvalidasi pengguna dengan menggunakan kontrol masuk dalam kode aplikasi Anda. Contoh ini memerlukan kontrol TextBox bernama usernameTextBox, kontrol TextBox bernama passwordTextBox, dan kontrol CheckBox bernama 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

Keterangan

Anda dapat menggunakan layanan aplikasi klien untuk memvalidasi pengguna dengan menggunakan autentikasi formulir. Untuk memvalidasi pengguna, Anda biasanya akan memanggil metode staticMembership.ValidateUser, yang secara internal memanggil metode ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String). Atau, Anda dapat memanggil metode ClientFormsAuthenticationMembershipProvider.ValidateUser secara langsung. Anda dapat memanggil kelebihan beban ini untuk meneruskan nilai rememberMe selain nilai username dan password.

Lihat juga

ValidateUser(String, String)
Client Application Services
Cara: Mengonfigurasi Layanan Aplikasi Klien
Cara: Menerapkan Login dan Keluar Pengguna dengan Layanan Aplikasi Klien

Berlaku untuk

ValidateUser(String, String, String)

Mengautentikasi pengguna di URI layanan yang ditentukan dengan menggunakan nama pengguna dan kata sandi yang ditentukan.

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

Parameter

username: String

Nama pengguna yang akan diautentikasi.

password: String

Kata sandi pengguna untuk mengautentikasi.

serviceUri: String

URI layanan autentikasi yang akan digunakan.

Mengembalikan

Boolean

true jika pengguna diautentikasi; jika tidak, false.

Pengecualian

WebException

Nilai properti IsOfflinefalse dan penyedia keanggotaan tidak dapat mengakses layanan autentikasi.

Contoh

Contoh kode berikut menunjukkan cara menggunakan metode ini untuk memvalidasi pengguna melalui layanan autentikasi di lokasi tertentu. Kredensial pengguna diambil dari kontrol masuk dalam kode aplikasi Anda. Contoh ini memerlukan kontrol TextBox bernama usernameTextBox dan kontrol TextBox bernama 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

Keterangan

Anda dapat menggunakan layanan aplikasi klien untuk memvalidasi pengguna dengan menggunakan autentikasi formulir. Untuk memvalidasi pengguna, Anda biasanya akan memanggil metode staticMembership.ValidateUser, yang secara internal memanggil metode ClientFormsAuthenticationMembershipProvider.ValidateUser. Atau, Anda dapat memanggil metode ClientFormsAuthenticationMembershipProvider.ValidateUser secara langsung. Anda dapat memanggil kelebihan beban ini untuk mengakses layanan autentikasi di lokasi yang ditentukan oleh parameter serviceUri. Menggunakan kelebihan beban ini adalah alternatif untuk mengatur properti ServiceUri dan memanggil kelebihan beban ValidateUser(String, String).

Lihat juga

ValidateUser(String, String)
Client Application Services
Cara: Mengonfigurasi Layanan Aplikasi Klien
Cara: Menerapkan Login dan Keluar Pengguna dengan Layanan Aplikasi Klien

Berlaku untuk

Bagikan melalui

ClientFormsAuthenticationMembershipProvider.ValidateUser Metode

Definisi

Overload

ValidateUser(String, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

ValidateUser(String, String, Boolean)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

ValidateUser(String, String, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Sumber Daya Tambahan: