SqlMembershipProvider Kelas
Definisi
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.
Mengelola penyimpanan informasi keanggotaan untuk aplikasi ASP.NET dalam database SQL Server.
public ref class SqlMembershipProvider : System::Web::Security::MembershipProvider
public class SqlMembershipProvider : System.Web.Security.MembershipProvider
type SqlMembershipProvider = class
inherit MembershipProvider
Public Class SqlMembershipProvider
Inherits MembershipProvider
- Warisan
Contoh
Contoh kode berikut menunjukkan file Web.config untuk aplikasi ASP.NET yang dikonfigurasi untuk menggunakan SqlMembershipProvider.
<configuration>
<connectionStrings>
<add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />
</connectionStrings>
<system.web>
<authentication mode="Forms" >
<forms loginUrl="login.aspx"
name=".ASPXFORMSAUTH" />
</authentication>
<authorization>
<deny users="?" />
</authorization>
<membership defaultProvider="SqlProvider"
userIsOnlineTimeWindow="15">
<providers>
<add
name="SqlProvider"
type="System.Web.Security.SqlMembershipProvider"
connectionStringName="SqlServices"
applicationName="MyApplication"
enablePasswordRetrieval="false"
enablePasswordReset="true"
requiresQuestionAndAnswer="true"
requiresUniqueEmail="false"
passwordFormat="Hashed"
maxInvalidPasswordAttempts="5"
passwordAttemptWindow="10" />
</providers>
</membership>
</system.web>
</configuration>
Keterangan
Catatan
ASP.NET penyedia keanggotaan telah digantikan oleh identitas ASP.NET. Kami sangat menyarankan untuk memperbarui aplikasi untuk menggunakan platform identitas ASP.NET alih-alih penyedia keanggotaan.
Kelas ini digunakan oleh Membership kelas dan MembershipUser untuk menyediakan layanan keanggotaan untuk aplikasi ASP.NET menggunakan database SQL Server. Anda tidak dapat menggunakan SqlMembershipProvider tanpa SQL Server. Ketika komputer Anda memiliki SQL Server Express yang diinstal dengan nama instans default dan instans pengguna diaktifkan, SqlMembershipProvider objek akan membuat database yang disebut aspnetdb
di direktori aplikasi App_Data
saat pertama kali aplikasi dijalankan.
Untuk membuat database secara manual, jalankan executable yang Aspnet_regsql.exe
ditemukan di %systemroot%\Microsoft.NET\Framework\ versionNumber
folder dan tentukan -A m
opsi (misalnya aspnet_regsql.exe -A m
). Database yang dibuat disebut Aspnetdb. Atau, jalankan Aspnet_regsql.exe
untuk menarik mode konfigurasi GUI dan pilih untuk mengonfigurasi semua Fitur ASP.NET.
Jika penyedia keanggotaan dikonfigurasi dengan string koneksi yang menggunakan keamanan terintegrasi, akun proses aplikasi ASP.NET harus memiliki hak untuk terhubung ke database SQL Server.
File Machine.config menentukan instans default SqlMembershipProvider bernama AspNetSqlMembershipProvider
yang terhubung ke instans SQL Server Express default pada komputer lokal. Anda dapat menggunakan instans penyedia ini jika Anda menginstal SQL Server Express dengan nama instans default, atau Anda dapat menentukan instans Anda sendiri dalam file Web.config untuk aplikasi ASP.NET Anda.
Jika Anda mengatur passwordCompatMode
atribut ke Framework40, aplikasi dapat menggunakan opsi keanggotaan hashing dan enkripsi yang ditambahkan di ASP.NET 4. Namun, jika passwordCompatMode
atribut diatur ke Framework20, hanya opsi keanggotaan hashing dan enkripsi dari ASP.NET 2.0, ASP.NET 3.5, dan ASP.NET 3.5 SP1 yang dapat digunakan. Nilai defaultnya adalah Framework20. Untuk informasi selengkapnya, lihat MembershipPasswordCompatibilityMode.
Konstruktor
SqlMembershipProvider() |
Menginisialisasi instans baru kelas SqlMembershipProvider. |
Properti
ApplicationName |
Mendapatkan atau mengatur nama aplikasi untuk menyimpan dan mengambil informasi keanggotaan. |
Description |
Mendapatkan deskripsi singkat dan ramah yang cocok untuk ditampilkan di alat administratif atau antarmuka pengguna (UI) lainnya. (Diperoleh dari ProviderBase) |
EnablePasswordReset |
Mendapatkan nilai yang menunjukkan apakah penyedia keanggotaan SQL Server dikonfigurasi untuk memungkinkan pengguna mengatur ulang kata sandi mereka. |
EnablePasswordRetrieval |
Mendapatkan nilai yang menunjukkan apakah penyedia keanggotaan SQL Server dikonfigurasi untuk memungkinkan pengguna mengambil kata sandi mereka. |
MaxInvalidPasswordAttempts |
Mendapatkan jumlah upaya kata sandi atau jawaban kata sandi yang tidak valid yang diizinkan sebelum pengguna keanggotaan dikunci. |
MinRequiredNonAlphanumericCharacters |
Mendapatkan jumlah minimum karakter khusus yang harus ada dalam kata sandi yang valid. |
MinRequiredPasswordLength |
Mendapatkan panjang minimum yang diperlukan untuk kata sandi. |
Name |
Mendapatkan nama ramah yang digunakan untuk merujuk ke penyedia selama konfigurasi. (Diperoleh dari ProviderBase) |
PasswordAttemptWindow |
Mendapatkan jendela waktu antara upaya gagal berturut-turut untuk memberikan kata sandi atau jawaban kata sandi yang valid dilacak. |
PasswordFormat |
Mendapatkan nilai yang menunjukkan format untuk menyimpan kata sandi dalam database keanggotaan SQL Server. |
PasswordStrengthRegularExpression |
Mendapatkan ekspresi reguler yang digunakan untuk mengevaluasi kata sandi. |
RequiresQuestionAndAnswer |
Mendapatkan nilai yang menunjukkan apakah penyedia keanggotaan SQL Server dikonfigurasi untuk mengharuskan pengguna menjawab pertanyaan kata sandi untuk reset dan pengambilan kata sandi. |
RequiresUniqueEmail |
Mendapatkan nilai yang menunjukkan apakah penyedia keanggotaan SQL Server dikonfigurasi untuk memerlukan alamat email unik untuk setiap nama pengguna. |
Metode
ChangePassword(String, String, String) |
Memodifikasi kata sandi pengguna. |
ChangePasswordQuestionAndAnswer(String, String, String, String) |
Memperbarui pertanyaan dan jawaban kata sandi untuk pengguna di database keanggotaan SQL Server. |
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) |
Menambahkan pengguna baru ke database keanggotaan SQL Server. |
DecryptPassword(Byte[]) |
Mendekripsi kata sandi terenkripsi. (Diperoleh dari MembershipProvider) |
DeleteUser(String, Boolean) |
Menghapus informasi keanggotaan pengguna dari database keanggotaan SQL Server. |
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) |
Mengembalikan kumpulan pengguna keanggotaan yang bidang alamat emailnya berisi alamat email yang ditentukan. |
FindUsersByName(String, Int32, Int32, Int32) |
Mendapatkan kumpulan pengguna keanggotaan di mana nama pengguna berisi nama pengguna yang ditentukan untuk dicocokkan. |
GeneratePassword() |
Menghasilkan kata sandi acak yang panjangnya minimal 14 karakter. |
GetAllUsers(Int32, Int32, Int32) |
Mendapatkan kumpulan semua pengguna dalam database keanggotaan SQL Server. |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetNumberOfUsersOnline() |
Mengembalikan jumlah pengguna yang saat ini mengakses aplikasi. |
GetPassword(String, String) |
Mengembalikan kata sandi untuk nama pengguna yang ditentukan dari database keanggotaan SQL Server. |
GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
GetUser(Object, Boolean) |
Mendapatkan informasi dari sumber data untuk pengguna keanggotaan yang terkait dengan pengidentifikasi unik yang ditentukan dan memperbarui stempel tanggal/waktu aktivitas terakhir untuk pengguna, jika ditentukan. |
GetUser(String, Boolean) |
Mengembalikan informasi dari database keanggotaan SQL Server untuk pengguna dan menyediakan opsi untuk memperbarui stempel tanggal/waktu aktivitas terakhir untuk pengguna. |
GetUserNameByEmail(String) |
Mendapatkan nama pengguna yang terkait dengan alamat email yang ditentukan. |
Initialize(String, NameValueCollection) |
Menginisialisasi penyedia keanggotaan SQL Server dengan nilai properti yang ditentukan dalam file konfigurasi aplikasi ASP.NET. Metode ini tidak dimaksudkan untuk digunakan langsung dari kode Anda. |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
OnValidatingPassword(ValidatePasswordEventArgs) |
Menaikkan ValidatingPassword peristiwa jika penanganan aktivitas telah ditentukan. (Diperoleh dari MembershipProvider) |
ResetPassword(String, String) |
Mereset kata sandi pengguna ke kata sandi baru yang dibuat secara otomatis. |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
UnlockUser(String) |
Menghapus status pengguna yang terkunci sehingga pengguna keanggotaan dapat divalidasi. |
UpdateUser(MembershipUser) |
Memperbarui informasi tentang pengguna di database keanggotaan SQL Server. |
ValidateUser(String, String) |
Memverifikasi bahwa nama pengguna dan kata sandi yang ditentukan ada di database keanggotaan SQL Server. |
Acara
ValidatingPassword |
Terjadi saat pengguna dibuat, kata sandi diubah, atau kata sandi diatur ulang. (Diperoleh dari MembershipProvider) |