SqlMembershipProvider Kelas

Definisi

Ruang nama:

System.Web.Security

Rakitan:

System.Web.dll

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

Object

ProviderBase

MembershipProvider

SqlMembershipProvider

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 ASP.NET Identity. Kami sangat menyarankan untuk memperbarui aplikasi untuk menggunakan platform ASP.NET Identity 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 telah SQL Server Express diinstal dengan nama instans default dan user-instancing 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 hashing dan keanggotaan 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 yang mudah diingat yang digunakan untuk merujuk ke penyedia selama konfigurasi. (Diperoleh dari ProviderBase)
PasswordAttemptWindow	Mendapatkan jendela waktu di 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)	Updates 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 setidaknya 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 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 yang 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 dikunci sehingga pengguna keanggotaan dapat divalidasi.
UpdateUser(MembershipUser)	Updates 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)

Lihat juga

• Pengantar Keanggotaan ASP.NET