ClientFormsAuthenticationMembershipProvider Kelas

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.

Mengaktifkan autentikasi formulir dengan layanan aplikasi klien.

public ref class ClientFormsAuthenticationMembershipProvider : System::Web::Security::MembershipProvider

public class ClientFormsAuthenticationMembershipProvider : System.Web.Security.MembershipProvider

type ClientFormsAuthenticationMembershipProvider = class
    inherit MembershipProvider

Public Class ClientFormsAuthenticationMembershipProvider
Inherits MembershipProvider

Warisan: Object

ProviderBase

MembershipProvider
ClientFormsAuthenticationMembershipProvider

Contoh

Contoh kode berikut menunjukkan cara menggunakan metode ini untuk memvalidasi pengguna dengan menggunakan implementasi IClientFormsAuthenticationCredentialsProvider.

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

Anda dapat menggunakan layanan aplikasi klien untuk memvalidasi pengguna dengan menggunakan autentikasi formulir. Untuk mengaktifkan autentikasi formulir, Anda mengonfigurasi aplikasi untuk menggunakan kelas ClientFormsAuthenticationMembershipProvider.

Setelah konfigurasi, Anda dapat memvalidasi pengguna dengan memanggil metode staticMembership.ValidateUser, yang secara internal memanggil metode ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String).

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. Penyedia kredensial adalah implementasi IClientFormsAuthenticationCredentialsProvider yang ditentukan dalam file konfigurasi aplikasi Anda. Anda biasanya akan menerapkan metode IClientFormsAuthenticationCredentialsProvider.GetCredentials untuk menampilkan kotak dialog masuk dan mengembalikan objek ClientFormsAuthenticationCredentials yang diisi. Menggunakan penyedia kredensial memungkinkan Anda berbagi satu kotak dialog masuk di antara beberapa aplikasi.

Metode ClientFormsAuthenticationMembershipProvider.ValidateUser mengautentikasi pengguna melalui layanan masuk yang ditunjukkan oleh properti ServiceUri. Nilai properti ServiceUri biasanya diambil dari file konfigurasi aplikasi bersama dengan nilai konfigurasi lainnya.

Jika pengguna berhasil diautentikasi, penyedia layanan mengatur properti staticThread.CurrentPrincipal ke objek ClientRolePrincipal baru yang berisi objek ClientFormsIdentity baru yang berisi informasi pengguna. Jika ClientRoleProvider dikonfigurasi untuk aplikasi Anda, Anda dapat menggunakan objek ClientRolePrincipal untuk mengambil informasi peran pengguna dari layanan peran.

Anda dapat mengambil referensi ke instans ClientFormsAuthenticationMembershipProvider saat ini melalui properti staticMembership.Provider. Anda dapat menggunakan referensi penyedia keanggotaan untuk memanggil metode ClientFormsAuthenticationMembershipProvider.ValidateUser secara langsung. Selain itu, Anda akan memerlukan referensi penyedia keanggotaan untuk memanggil metode Logout, yang tidak tersedia di kelas dasar MembershipProvider.

Anda tidak dapat menggunakan kelas ClientFormsAuthenticationMembershipProvider untuk membuat, menghapus, atau mengubah informasi keanggotaan. Untuk membuat, menghapus, atau mengubah pengguna, Anda harus mengubah konfigurasi layanan masuk di server.

Konstruktor

ClientFormsAuthenticationMembershipProvider()

Menginisialisasi instans baru kelas ClientFormsAuthenticationMembershipProvider.

Properti

ApplicationName	Properti ini tidak digunakan oleh kelas ini.
Description	Mendapatkan deskripsi singkat dan ramah yang cocok untuk ditampilkan di alat administratif atau antarmuka pengguna (UI) lainnya. (Diperoleh dari ProviderBase)
EnablePasswordReset	Properti ini tidak digunakan oleh kelas ini.
EnablePasswordRetrieval	Properti ini tidak digunakan oleh kelas ini.
MaxInvalidPasswordAttempts	Properti ini tidak digunakan oleh kelas ini.
MinRequiredNonAlphanumericCharacters	Properti ini tidak digunakan oleh kelas ini.
MinRequiredPasswordLength	Properti ini tidak digunakan oleh kelas ini.
Name	Mendapatkan nama yang mudah diingat yang digunakan untuk merujuk ke penyedia selama konfigurasi. (Diperoleh dari ProviderBase)
PasswordAttemptWindow	Properti ini tidak digunakan oleh kelas ini.
PasswordFormat	Properti ini tidak digunakan oleh kelas ini.
PasswordStrengthRegularExpression	Properti ini tidak digunakan oleh kelas ini.
RequiresQuestionAndAnswer	Properti ini tidak digunakan oleh kelas ini.
RequiresUniqueEmail	Properti ini tidak digunakan oleh kelas ini.
ServiceUri	Mendapatkan atau mengatur URI layanan autentikasi.

Metode

ChangePassword(String, String, String)	Metode ini tidak digunakan oleh kelas ini.
ChangePasswordQuestionAndAnswer(String, String, String, String)	Metode ini tidak digunakan oleh kelas ini.
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	Metode ini tidak digunakan oleh kelas ini.
DecryptPassword(Byte[])	Mendekripsi kata sandi terenkripsi. (Diperoleh dari MembershipProvider)
DeleteUser(String, Boolean)	Metode ini tidak digunakan oleh kelas ini.
EncryptPassword(Byte[])	Mengenkripsi kata sandi. (Diperoleh dari MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	Mengenkripsi kata sandi yang ditentukan menggunakan mode kompatibilitas kata sandi yang ditentukan. (Diperoleh dari MembershipProvider)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FindUsersByEmail(String, Int32, Int32, Int32)	Metode ini tidak digunakan oleh kelas ini.
FindUsersByName(String, Int32, Int32, Int32)	Metode ini tidak digunakan oleh kelas ini.
GetAllUsers(Int32, Int32, Int32)	Metode ini tidak digunakan oleh kelas ini.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetNumberOfUsersOnline()	Metode ini tidak digunakan oleh kelas ini.
GetPassword(String, String)	Metode ini tidak digunakan oleh kelas ini.
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
GetUser(Object, Boolean)	Metode ini tidak digunakan oleh kelas ini.
GetUser(String, Boolean)	Metode ini tidak digunakan oleh kelas ini.
GetUserNameByEmail(String)	Metode ini tidak digunakan oleh kelas ini.
Initialize(String, NameValueCollection)	Menginisialisasi penyedia.
Logout()	Keluarkan pengguna.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnValidatingPassword(ValidatePasswordEventArgs)	Menaikkan peristiwa ValidatingPassword jika penanganan aktivitas telah ditentukan. (Diperoleh dari MembershipProvider)
ResetPassword(String, String)	Metode ini tidak digunakan oleh kelas ini.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
UnlockUser(String)	Metode ini tidak digunakan oleh kelas ini.
UpdateUser(MembershipUser)	Metode ini tidak digunakan oleh kelas ini.
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.

Acara

UserValidated	Terjadi ketika pengguna divalidasi.
ValidatingPassword	Terjadi saat pengguna dibuat, kata sandi diubah, atau kata sandi diatur ulang. (Diperoleh dari MembershipProvider)

Berlaku untuk

Lihat juga

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

Bagikan melalui