SqlMembershipProvider Sınıf

Tanım

Ad Alanı:

System.Web.Security

Bütünleştirilmiş Kod:

System.Web.dll

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

Object

ProviderBase

MembershipProvider

SqlMembershipProvider

Ö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

Note

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 kullanacak şekilde uygulamaları güncelleştirmenizi kesinlikle öneririz.

Bu sınıf, Membership ve MembershipUser sınıfları tarafından SQL Server veritabanı kullanarak bir ASP.NET uygulaması için üyelik hizmetleri sağlamak üzere kullanılır. SQL Server olmadan SqlMembershipProvider kullanamazsınız. Bilgisayarınızda varsayılan örnek adıyla SQL Server Express yüklüyse ve kullanıcı koruması etkinleştirildiğinde, SqlMembershipProvider nesnesi uygulamanın ilk çalıştırıldığında uygulamanın aspnetdb dizininde App_Data adlı bir veritabanı oluşturur.

Veritabanını el ile oluşturmak için, Aspnet_regsql.exe klasöründe bulunan %systemroot%\Microsoft.NET\Framework\ versionNumber yürütülebilir dosyasını çalıştırın ve -A m seçeneğini belirtin (örneğin aspnet_regsql.exe -A m). Oluşturulan veritabanı Aspnetdb olarak adlandırılır. Alternatif olarak, GUI yapılandırma modunu yukarı çekmek için Aspnet_regsql.exe çalıştırın 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ı dizesi ile 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 SQL Server Express örneğine bağlanan SqlMembershipProvider adlı bir varsayılan AspNetSqlMembershipProvider ö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.

passwordCompatMode özniteliğini Framework40 olarak ayarlarsanız, uygulama ASP.NET 4'te eklenen karma ve şifreleme üyeliği seçeneklerini kullanabilir. Ancak, passwordCompatMode özniteliği Framework20 olarak ayarlanırsa, 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

Name	Description
SqlMembershipProvider()	SqlMembershipProvider sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
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 karakter alır.
MinRequiredPasswordLength	Parola için gereken en düşük 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 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

Name	Description
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[], MembershipPasswordCompatibilityMode)	Belirtilen parolayı belirtilen parola uyumluluk modunu kullanarak şifreler. (Devralındığı yer: MembershipProvider)
EncryptPassword(Byte[])	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ının belirtilen e-posta adresini içerdiği üyelik kullanıcılarından oluşan bir koleksiyon 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ından oluşan bir koleksiyon 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 bir 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ı 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()	Geçerli örneğin Type 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 belirtildiyse 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ı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)	SQL Server üyelik sağlayıcısını, ASP.NET uygulamasını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 Objectbasit 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 bir dize 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

Name	Description
ValidatingPassword	Kullanıcı oluşturulduğunda, parola değiştirildiğinde veya parola sıfırlandığında gerçekleşir. (Devralındığı yer: MembershipProvider)

Ayrıca bkz.

• ASP.NET Üyeliğine Giriş