SqlMembershipProvider Sınıf

Tanım

SQL Server veritabanındaki bir ASP.NET uygulamasının Üyelik bilgilerinin depolanmasını yönetir.Manages storage of membership information for an ASP.NET application in a SQL Server database.

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
SqlMembershipProvider

Örnekler

Aşağıdaki kod örneği, kullanmak üzere yapılandırılmış bir ASP.NET uygulamasının Web.config dosyasını gösterir SqlMembershipProvider .The following code example shows the Web.config file for an ASP.NET application configured to use a 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>  

Açıklamalar

Bu sınıf, ve sınıfları tarafından, bir Membership MembershipUser SQL Server veritabanı kullanarak bir ASP.NET uygulaması için üyelik hizmetleri sağlamak üzere kullanılır.This class is used by the Membership and MembershipUser classes to provide membership services for an ASP.NET application using a SQL Server database. SqlMembershipProviderSQL Server olmadan kullanamazsınız.You cannot use a SqlMembershipProvider without SQL Server. Bilgisayarınızın varsayılan örnek adı ve Kullanıcı örneklemesini etkin SQL Server Express yüklendiği zaman, SqlMembershipProvider nesne aspnetdb ilk çalıştırıldığında uygulamanın dizininde adlı bir veritabanı oluşturur App_Data .When your computer has SQL Server Express installed with the default instance name and user-instancing enabled, the SqlMembershipProvider object will create a database called aspnetdb in the application's App_Data directory the first time the application is run.

Veritabanını el ile oluşturmak için, Aspnet_regsql.exe klasörde bulunan yürütülebiliri çalıştırın %systemroot%\Microsoft.NET\Framework\ versionNumber ve -A m seçeneğini belirtin (örneğin aspnet_regsql.exe -A m ).To manually create the database, run the Aspnet_regsql.exe executable found in the %systemroot%\Microsoft.NET\Framework\ versionNumber folder and specify the -A m option (for example aspnet_regsql.exe -A m). Oluşturulan veritabanına aspnetdb adı verilir.The database created is called Aspnetdb. Alternatif olarak, Aspnet_regsql.exe GUI yapılandırma modunu çekmek ve tüm ASP.NET özelliklerini yapılandırmayı seçmek için komutunu çalıştırın.Alternatively, run Aspnet_regsql.exe to pull up the GUI configuration mode and choose to configure all ASP.NET Features.

Üyelik sağlayıcısı, tümleşik güvenlik kullanan bir bağlantı dizesiyle yapılandırıldıysa, ASP.NET uygulamasının işlem hesabı SQL Server veritabanına bağlanma haklarına sahip olmalıdır.If the membership provider is configured with a connection string that uses integrated security, the process account of the ASP.NET application must have rights to connect to the SQL Server database.

Machine.config dosyası, SqlMembershipProvider AspNetSqlMembershipProvider yerel makinedeki varsayılan SQL Server Express örneğine bağlanan adlı bir varsayılan örneği tanımlar.The Machine.config file defines a default SqlMembershipProvider instance named AspNetSqlMembershipProvider that connects to the default SQL Server Express instance on the local machine. Varsayılan örnek adı ile 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.You can use this instance of the provider if you installed SQL Server Express with the default instance name, or you can define your own instance in the Web.config file for your ASP.NET application.

passwordCompatModeÖzniteliğini olarak ayarlarsanız Framework40 , uygulama ASP.NET 4 ' te eklenen karma ve şifreleme üyeliği seçeneklerini kullanabilir.If you set the passwordCompatMode attribute to Framework40, the application can use the hashing and encryption membership options that were added in ASP.NET 4. Ancak, passwordCompatMode özniteliği olarak ayarlandıysa Framework20 , yalnızca ASP.NET 2,0, ASP.NET 3,5 ve ASP.NET 3,5 SP1 'in karma ve şifreleme üyelik seçenekleri kullanılabilir.However, if the passwordCompatMode attribute is set to Framework20, only the hashing and encryption membership options from the ASP.NET 2.0, ASP.NET 3.5, and ASP.NET 3.5 SP1 can be used. Varsayılan değer: Framework20.The default value is Framework20. Daha fazla bilgi için bkz. MembershipPasswordCompatibilityMode.For more information, see MembershipPasswordCompatibilityMode.

Oluşturucular

SqlMembershipProvider()

SqlMembershipProvider sınıfının yeni bir örneğini başlatır.Initializes a new instance of the SqlMembershipProvider class.

Özellikler

ApplicationName

İçin üyelik bilgilerini depolamak ve almak için uygulamanın adını alır veya ayarlar.Gets or sets the name of the application to store and retrieve membership information for.

Description

Yönetim araçlarında veya diğer kullanıcı arabirimlerinde (Usıs) görüntülenmek üzere uygun olan kısa, kolay bir açıklama alır.Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(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 vermek üzere yapılandırılıp yapılandırılmadığını gösteren bir değer alır.Gets a value indicating whether the SQL Server membership provider is configured to allow users to reset their passwords.

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ı gösteren bir değer alır.Gets a value indicating whether the SQL Server membership provider is configured to allow users to retrieve their passwords.

MaxInvalidPasswordAttempts

Üyelik kullanıcısı kilitlenmeden önce izin verilen geçersiz parola veya parola yanıtı sayısını alır.Gets the number of invalid password or password-answer attempts allowed before the membership user is locked out.

MinRequiredNonAlphanumericCharacters

Geçerli bir parolada bulunması gereken en az özel karakter sayısını alır.Gets the minimum number of special characters that must be present in a valid password.

MinRequiredPasswordLength

Parola için gereken en düşük uzunluğu alır.Gets the minimum length required for a password.

Name

Yapılandırma sırasında sağlayıcıya başvurmak için kullanılan kolay adı alır.Gets the friendly name used to refer to the provider during configuration.

(Devralındığı yer: ProviderBase)
PasswordAttemptWindow

Geçerli bir parola sağlamak için ardışık başarısız denemelere veya parola yanıtlarının izlenme arasındaki zaman penceresini alır.Gets the time window between which consecutive failed attempts to provide a valid password or password answers are tracked.

PasswordFormat

SQL Server üyelik veritabanında parolaları depolama biçimini gösteren bir değer alır.Gets a value indicating the format for storing passwords in the SQL Server membership database.

PasswordStrengthRegularExpression

Bir parolayı değerlendirmek için kullanılan normal ifadeyi alır.Gets the regular expression used to evaluate a password.

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ı gerektirmek üzere yapılandırılıp yapılandırılmadığını belirten bir değer alır.Gets a value indicating whether the SQL Server membership provider is configured to require the user to answer a password question for password reset and retrieval.

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ı gösteren bir değer alır.Gets a value indicating whether the SQL Server membership provider is configured to require a unique email address for each user name.

Yöntemler

ChangePassword(String, String, String)

Kullanıcının parolasını değiştirir.Modifies a user's password.

ChangePasswordQuestionAndAnswer(String, String, String, String)

SQL Server üyelik veritabanındaki bir kullanıcının parola sorusunu ve yanıtını güncelleştirir.Updates the password question and answer for a user in the SQL Server membership database.

CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)

SQL Server üyelik veritabanına yeni bir kullanıcı ekler.Adds a new user to the SQL Server membership database.

DecryptPassword(Byte[])

Şifrelenmiş bir parolanın şifresini çözer.Decrypts an encrypted password.

(Devralındığı yer: MembershipProvider)
DeleteUser(String, Boolean)

Kullanıcının üyelik bilgilerini SQL Server üyelik veritabanından kaldırır.Removes a user's membership information from the SQL Server membership database.

EncryptPassword(Byte[])

Parolayı şifreler.Encrypts a password.

(Devralındığı yer: MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)

Belirtilen parola-uyumluluk modunu kullanarak belirtilen parolayı şifreler.Encrypts the specified password using the specified password-compatibility mode.

(Devralındığı yer: MembershipProvider)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
FindUsersByEmail(String, Int32, Int32, Int32)

E-posta adresi alanı belirtilen e-posta adresini içeren bir üyelik kullanıcıları koleksiyonu döndürür.Returns a collection of membership users for which the email address field contains the specified email address.

FindUsersByName(String, Int32, Int32, Int32)

Kullanıcı adının eşleştirilecek belirtilen kullanıcı adını içerdiği üyelik kullanıcıları koleksiyonunu alır.Gets a collection of membership users where the user name contains the specified user name to match.

GeneratePassword()

En az 14 karakter uzunluğunda rastgele bir parola üretir.Generates a random password that is at least 14 characters long.

GetAllUsers(Int32, Int32, Int32)

SQL Server üyelik veritabanındaki tüm kullanıcıların koleksiyonunu alır.Gets a collection of all the users in the SQL Server membership database.

GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetNumberOfUsersOnline()

Uygulamaya şu anda erişen kullanıcı sayısını döndürür.Returns the number of users currently accessing the application.

GetPassword(String, String)

SQL Server üyelik veritabanından belirtilen kullanıcı adının parolasını döndürür.Returns the password for the specified user name from the SQL Server membership database.

GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
GetUser(Object, Boolean)

Belirtilen benzersiz tanımlayıcıyla ilişkili üyelik kullanıcısına ait veri kaynağından bilgileri alır ve belirtilmişse kullanıcının son etkinlik tarih/saat damgasını günceller.Gets the information from the data source for the membership user associated with the specified unique identifier and updates the last activity date/time stamp for the user, if specified.

GetUser(String, Boolean)

Kullanıcının SQL Server üyelik veritabanından bilgi döndürür ve Kullanıcı için son etkinlik tarih/saat damgasını güncelleştirmek için bir seçenek sağlar.Returns information from the SQL Server membership database for a user and provides an option to update the last activity date/time stamp for the user.

GetUserNameByEmail(String)

Belirtilen e-posta adresiyle ilişkili kullanıcı adını alır.Gets the user name associated with the specified email address.

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.Initializes the SQL Server membership provider with the property values specified in the ASP.NET application's configuration file. Bu yöntem doğrudan kodunuzdan kullanılmaya yönelik değildir.This method is not intended to be used directly from your code.

MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
OnValidatingPassword(ValidatePasswordEventArgs)

ValidatingPasswordBir olay işleyicisi tanımlanmışsa olayı başlatır.Raises the ValidatingPassword event if an event handler has been defined.

(Devralındığı yer: MembershipProvider)
ResetPassword(String, String)

Kullanıcının parolasını yeni, otomatik olarak oluşturulan bir parolaya sıfırlar.Resets a user's password to a new, automatically generated password.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)
UnlockUser(String)

Üyelik kullanıcısının onaylanabilmesi için kullanıcının kilitli durumunu temizler.Clears the user's locked-out status so that the membership user can be validated.

UpdateUser(MembershipUser)

SQL Server üyelik veritabanındaki bir kullanıcıyla ilgili bilgileri güncelleştirir.Updates information about a user in the SQL Server membership database.

ValidateUser(String, String)

SQL Server üyelik veritabanında belirtilen Kullanıcı adı ve parolanın mevcut olduğunu doğrular.Verifies that the specified user name and password exist in the SQL Server membership database.

Ekinlikler

ValidatingPassword

Bir kullanıcı oluşturulduğunda, bir parola değiştirildiğinde veya bir parola sıfırlandığında gerçekleşir.Occurs when a user is created, a password is changed, or a password is reset.

(Devralındığı yer: MembershipProvider)

Şunlara uygulanır

Ayrıca bkz.