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 IClientFormsAuthenticationCredentialsProvider implementasi.

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 ClientFormsAuthenticationMembershipProvider kelas .

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

Autentikasi formulir mengharuskan pengguna menentukan kredensial mereka melalui kontrol login yang disediakan oleh aplikasi Anda. Anda dapat mengambil kredensial dan meneruskannya ke Membership.ValidateUser metode . Anda juga dapat meneruskan string kosong atau null menggunakan penyedia kredensial. Penyedia kredensial adalah implementasi yang IClientFormsAuthenticationCredentialsProvider ditentukan dalam file konfigurasi aplikasi Anda. Anda biasanya akan menerapkan IClientFormsAuthenticationCredentialsProvider.GetCredentials metode untuk menampilkan kotak dialog masuk dan mengembalikan objek yang diisi ClientFormsAuthenticationCredentials . Menggunakan penyedia kredensial memungkinkan Anda berbagi satu kotak dialog masuk di antara beberapa aplikasi.

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

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

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

Anda tidak dapat menggunakan ClientFormsAuthenticationMembershipProvider kelas 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 instans Type 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 yang saat ini Object. (Diperoleh dari Object)
OnValidatingPassword(ValidatePasswordEventArgs)	Menaikkan ValidatingPassword peristiwa 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

Bagikan melalui