SqlMembershipProvider Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
SQL Server veritabanındaki bir ASP.NET uygulaması için üyelik bilgilerinin depolanmasını yönetir.
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
- Devralma
Örnekler
Aşağıdaki kod örneği, kullanmak SqlMembershipProviderüzere yapılandırılmış bir ASP.NET uygulamasının Web.config dosyasını gösterir.
<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>
Açıklamalar
Not
ASP.NET üyelik sağlayıcılarının yerini ASP.NET Identity alır. Üyelik sağlayıcıları yerine ASP.NET Kimlik platformunu kullanmak için uygulamaları güncelleştirmenizi kesinlikle öneririz.
Bu sınıf, ve MembershipUser sınıfları tarafından Membership SQL Server veritabanı kullanan bir ASP.NET uygulaması için üyelik hizmetleri sağlamak için kullanılır. SQL Server olmadan kullanamazsınız SqlMembershipProvider . Bilgisayarınızda varsayılan örnek adıyla SQL Server Express yüklüyse ve kullanıcı oturum açma etkinleştirildiğinde, SqlMembershipProvider uygulama ilk çalıştırıldığında nesne uygulamanın App_Data
dizininde adlı aspnetdb
bir veritabanı oluşturur.
Veritabanını el ile oluşturmak için klasörde bulunan %systemroot%\Microsoft.NET\Framework\ versionNumber
yürütülebilir dosyayı çalıştırın Aspnet_regsql.exe
ve seçeneğini belirtin -A m
(örneğinaspnet_regsql.exe -A m
). Oluşturulan veritabanı Aspnetdb olarak adlandırılır. Alternatif olarak, GUI yapılandırma modunu çekmek için komutunu çalıştırın Aspnet_regsql.exe
ve tüm ASP.NET Özellikleri yapılandırmayı seçin.
Üyelik sağlayıcısı tümleşik güvenlik kullanan bir bağlantı dizesiyle yapılandırılmışsa, ASP.NET uygulamasının işlem hesabının SQL Server veritabanına bağlanma hakları olmalıdır.
Machine.config dosyası, yerel makinedeki varsayılan SqlMembershipProvider SQL Server Express örneğine bağlanan adlı AspNetSqlMembershipProvider
bir varsayılan örneği tanımlar. SQL Server Express'i varsayılan örnek adıyla yüklediyseniz sağlayıcının bu örneğini kullanabilir veya ASP.NET uygulamanızın Web.config dosyasında kendi örneğinizi tanımlayabilirsiniz.
özniteliğini passwordCompatMode
Framework40olarak ayarlarsanız, uygulama ASP.NET 4'te eklenen karma ve şifreleme üyeliği seçeneklerini kullanabilir. Ancak özniteliği olarak Framework20ayarlanırsa passwordCompatMode
yalnızca ASP.NET 2.0, ASP.NET 3.5 ve ASP.NET 3.5 SP1'den karma ve şifreleme üyeliği seçenekleri kullanılabilir.
Framework20 varsayılan değerdir. Daha fazla bilgi için bkz. MembershipPasswordCompatibilityMode.
Oluşturucular
SqlMembershipProvider() |
SqlMembershipProvider sınıfının yeni bir örneğini başlatır. |
Özellikler
ApplicationName |
Üyelik bilgilerini depolamak ve almak için uygulamanın adını alır veya ayarlar. |
Description |
Yönetim araçlarında veya diğer kullanıcı arabirimlerinde (UI) görüntülenmeye uygun kısa ve kolay bir açıklama alır. (Devralındığı yer: ProviderBase) |
EnablePasswordReset |
SQL Server üyelik sağlayıcısının kullanıcıların parolalarını sıfırlamasına izin verecek şekilde yapılandırılıp yapılandırılmadığını belirten bir değer alır. |
EnablePasswordRetrieval |
SQL Server üyelik sağlayıcısının kullanıcıların parolalarını almasına izin verecek şekilde yapılandırılıp yapılandırılmadığını belirten bir değer alır. |
MaxInvalidPasswordAttempts |
Üyelik kullanıcısı kilitlenmeden önce izin verilen geçersiz parola veya parola yanıtı denemelerinin sayısını alır. |
MinRequiredNonAlphanumericCharacters |
Geçerli bir parolada bulunması gereken en az özel karakter sayısını alır. |
MinRequiredPasswordLength |
Parola için gereken minimum uzunluğu alır. |
Name |
Yapılandırma sırasında sağlayıcıya başvurmak için kullanılan kolay adı alır. (Devralındığı yer: ProviderBase) |
PasswordAttemptWindow |
Geçerli bir parola sağlamaya yönelik ardışık başarısız girişimlerin veya parola yanıtlarının izlendiği zaman penceresini alır. |
PasswordFormat |
PAROLAları SQL Server üyelik veritabanında depolama biçimini gösteren bir değer alır. |
PasswordStrengthRegularExpression |
Parolayı değerlendirmek için kullanılan normal ifadeyi alır. |
RequiresQuestionAndAnswer |
SQL Server üyelik sağlayıcısının, parola sıfırlama ve alma için kullanıcının parola sorusunu yanıtlamasını gerektirecek şekilde yapılandırılıp yapılandırılmadığını belirten bir değer alır. |
RequiresUniqueEmail |
SQL Server üyelik sağlayıcısının her kullanıcı adı için benzersiz bir e-posta adresi gerektirecek şekilde yapılandırılıp yapılandırılmadığını belirten bir değer alır. |
Yöntemler
ChangePassword(String, String, String) |
Kullanıcının parolasını değiştirir. |
ChangePasswordQuestionAndAnswer(String, String, String, String) |
SQL Server üyelik veritabanındaki bir kullanıcının parola sorusunu ve yanıtını güncelleştirir. |
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) |
SQL Server üyelik veritabanına yeni bir kullanıcı ekler. |
DecryptPassword(Byte[]) |
Şifrelenmiş parolanın şifresini çözer. (Devralındığı yer: MembershipProvider) |
DeleteUser(String, Boolean) |
Kullanıcının üyelik bilgilerini SQL Server üyelik veritabanından kaldırır. |
EncryptPassword(Byte[]) |
Parolayı şifreler. (Devralındığı yer: MembershipProvider) |
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) |
Belirtilen parolayı belirtilen parola uyumluluk modunu kullanarak şifreler. (Devralındığı yer: MembershipProvider) |
Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
FindUsersByEmail(String, Int32, Int32, Int32) |
E-posta adresi alanının belirtilen e-posta adresini içerdiği bir üyelik kullanıcıları koleksiyonu döndürür. |
FindUsersByName(String, Int32, Int32, Int32) |
Kullanıcı adının eşleşecek belirtilen kullanıcı adını içerdiği üyelik kullanıcılarının bir koleksiyonunu alır. |
GeneratePassword() |
En az 14 karakter uzunluğunda rastgele bir parola oluşturur. |
GetAllUsers(Int32, Int32, Int32) |
SQL Server üyelik veritabanındaki tüm kullanıcıların koleksiyonunu alır. |
GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
GetNumberOfUsersOnline() |
Şu anda uygulamaya erişen kullanıcıların sayısını döndürür. |
GetPassword(String, String) |
SQL Server üyelik veritabanından belirtilen kullanıcı adı için parolayı döndürür. |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
GetUser(Object, Boolean) |
Belirtilen benzersiz tanımlayıcıyla ilişkilendirilmiş üyelik kullanıcısının veri kaynağından bilgileri alır ve belirtilmişse kullanıcının son etkinlik tarih/saat damgasını güncelleştirir. |
GetUser(String, Boolean) |
Bir kullanıcının SQL Server üyelik veritabanından bilgileri döndürür ve kullanıcının son etkinlik tarih/saat damgasını güncelleştirme seçeneği sağlar. |
GetUserNameByEmail(String) |
Belirtilen e-posta adresiyle ilişkili kullanıcı adını alır. |
Initialize(String, NameValueCollection) |
SQL Server üyelik sağlayıcısını ASP.NET uygulamanın yapılandırma dosyasında belirtilen özellik değerleriyle başlatır. Bu yöntem doğrudan kodunuzdan kullanılmak üzere tasarlanmamıştır. |
MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
OnValidatingPassword(ValidatePasswordEventArgs) |
Bir olay işleyicisi tanımlanmışsa olayı tetikler ValidatingPassword . (Devralındığı yer: MembershipProvider) |
ResetPassword(String, String) |
Kullanıcının parolasını yeni, otomatik olarak oluşturulan bir parolaya sıfırlar. |
ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
UnlockUser(String) |
Üyelik kullanıcısının doğrulanabilmesi için kullanıcının kilitli durumunu temizler. |
UpdateUser(MembershipUser) |
SQL Server üyelik veritabanındaki bir kullanıcı hakkındaki bilgileri güncelleştirir. |
ValidateUser(String, String) |
Belirtilen kullanıcı adı ve parolanın SQL Server üyelik veritabanında mevcut olduğunu doğrular. |
Ekinlikler
ValidatingPassword |
Kullanıcı oluşturulduğunda, parola değiştirildiğinde veya parola sıfırlandığında gerçekleşir. (Devralındığı yer: MembershipProvider) |