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ızSqlMembershipProvider. Bilgisayarınızda SQL Server Express varsayılan örnek adı ve kullanıcı oturum açma etkin olarak yüklendiğinde, SqlMembershipProvider nesne uygulama ilk kez çalıştırıldığında 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 açmak için komutunu çalıştırın Aspnet_regsql.exe
ve tüm ASP.NET Özelliklerini 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. Varsayılan örnek adıyla SQL Server Express 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
olarak Framework40ayarlarsanız, uygulama ASP.NET 4'e eklenen karma ve şifreleme üyeliği seçeneklerini kullanabilir. Ancak, özniteliği olarak Framework20ayarlanırsapasswordCompatMode
, 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 sayıda özel karakteri 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 veya parola yanıtları sağlamaya yönelik ardışık başarısız girişimlerin 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 kullanıcının parola sıfırlama ve alma için 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ştirmeler. |
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) |
SQL Server üyelik veritabanına yeni bir kullanıcı ekler. |
DecryptPassword(Byte[]) |
Şifrelenmiş bir 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 parola uyumluluk modunu kullanarak belirtilen parolayı ş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ında belirtilen e-posta adresinin bulunduğu 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ı 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ının parolasını 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şkili ü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) |
Kullanıcının SQL Server üyelik veritabanındaki 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) |
ASP.NET uygulamasının yapılandırma dosyasında belirtilen özellik değerleriyle SQL Server üyelik sağlayıcısını başlatır. Bu yöntemin doğrudan kodunuzdan kullanılması amaçlanmamış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ı otomatik olarak oluşturulan yeni 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ında bilgi Güncelleştirmeler. |
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) |
Şunlara uygulanır
Ayrıca bkz.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin