MembershipProvider 類別

定義

命名空間:

System.Web.Security

組件:

System.Web.ApplicationServices.dll

定義 ASP.NET 為使用成員資格提供者提供成員資格服務實作的合約。

public ref class MembershipProvider abstract : System::Configuration::Provider::ProviderBase

public abstract class MembershipProvider : System.Configuration.Provider.ProviderBase

type MembershipProvider = class
    inherit ProviderBase

Public MustInherit Class MembershipProvider
Inherits ProviderBase

繼承

Object

ProviderBase

MembershipProvider

衍生

System.Web.ClientServices.Providers.ClientFormsAuthenticationMembershipProvider

System.Web.ClientServices.Providers.ClientWindowsAuthenticationMembershipProvider

System.Web.Security.ActiveDirectoryMembershipProvider

System.Web.Security.SqlMembershipProvider

備註

注意

ASP.NET 身分識別 已取代 ASP.NET 成員資格提供者。 我們強烈建議更新應用程式，以使用 ASP.NET 身分識別平臺，而不是成員資格提供者。

ASP.NET 成員資格的設計目的是讓您輕鬆地針對 ASP.NET 應用程式使用許多不同的成員資格提供者。 您可以使用隨附於 .NET Framework 的已提供成員資格提供者，也可以實作自己的提供者。

注意

如果您不熟悉 ASP.NET 的成員資格功能，請參閱 成員資格簡介 ，再繼續進行。 如需與成員資格相關的其他主題清單，請參閱 使用成員資格管理使用者。

實作自定義成員資格提供者時，您必須繼承 MembershipProvider 抽象類。

建立自定義成員資格提供者有兩個主要原因。

• 您必須將成員資格資訊儲存在 .NET Framework 隨附的成員資格提供者不支持的數據源中，例如 FoxPro 資料庫、Oracle 資料庫或其他數據源。

• 您必須使用與 .NET Framework 隨附的提供者所使用的資料庫架構不同的資料庫架構來管理成員資格資訊。 常見的範例是已存在於公司或網站的 SQL Server 資料庫中的成員資格數據。

MembershipProvider抽象類繼承自ProviderBase抽象類。 MembershipProvider 實作也必須實作的必要成員 ProviderBase。

建構函式

MembershipProvider()

初始化 MembershipProvider 類別的新執行個體。

屬性

ApplicationName	使用自訂成員資格提供者的應用程式名稱。
Description	取得簡短、易讀的描述，適合顯示在管理工具或其他使用者介面 (UI) 中。 (繼承來源 ProviderBase)
EnablePasswordReset	表示是否將成員資格提供者設定成可讓使用者重設其密碼。
EnablePasswordRetrieval	指出是否將成員資格提供者設定成可讓使用者擷取其密碼。
MaxInvalidPasswordAttempts	取得鎖定成員資格使用者以前，所允許的無效密碼或密碼解答嘗試次數。
MinRequiredNonAlphanumericCharacters	取得有效的密碼中必須要有的特殊字元數目下限。
MinRequiredPasswordLength	取得密碼所需的最小長度。
Name	取得用來在設定期間代表提供者的易記名稱。 (繼承來源 ProviderBase)
PasswordAttemptWindow	取得鎖定成員資格使用者以前，所允許的無效密碼或密碼解答嘗試次數上限的分鐘數。
PasswordFormat	取得值，這個值表示將密碼儲存在成員資格資料存放區中的格式。
PasswordStrengthRegularExpression	取得用來評估密碼的規則運算式。
RequiresQuestionAndAnswer	取得值，指出將成員資格提供者設定為要求使用者回答密碼問題，以便重設密碼和擷取。
RequiresUniqueEmail	取得值，這個值表示成員資格提供者是否設定成需要每個使用者名稱有唯一的電子郵件地址。

方法

ChangePassword(String, String, String)	處理要求，以更新成員資格使用者的密碼。
ChangePasswordQuestionAndAnswer(String, String, String, String)	處理要求，以更新成員資格使用者的密碼問題和解答。
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	將新成員資格使用者加入資料來源。
DecryptPassword(Byte[])	解密加密的密碼。
DeleteUser(String, Boolean)	從成員資格資料來源中移除使用者。
EncryptPassword(Byte[])	將密碼加密。
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	使用指定的密碼相容模式，加密指定的密碼。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
FindUsersByEmail(String, Int32, Int32, Int32)	取得成員資格使用者集合，其中電子郵件地址包含要符合的指定電子郵件地址。
FindUsersByName(String, Int32, Int32, Int32)	取得成員資格使用者的集合，其中的使用者名稱包含必須符合的特定使用者名稱。
GetAllUsers(Int32, Int32, Int32)	取得資料頁面中資料來源所有使用者的集合。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetNumberOfUsersOnline()	取得目前存取應用程式的使用者數目。
GetPassword(String, String)	從資料來源取得指定使用者名稱的密碼。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
GetUser(Object, Boolean)	根據成員資格使用者的唯一識別碼，從資料來源取得使用者資訊。 提供選項，以更新使用者之上次活動日期/時間戳記。
GetUser(String, Boolean)	從使用者的資料來源取得資訊。 提供選項，以更新使用者之上次活動日期/時間戳記。
GetUserNameByEmail(String)	取得與所指定電子郵件地址建立關聯的使用者名稱。
Initialize(String, NameValueCollection)	初始化設定產生器。 (繼承來源 ProviderBase)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnValidatingPassword(ValidatePasswordEventArgs)	如果已定義事件處理常式，則引發 ValidatingPassword 事件。
ResetPassword(String, String)	將使用者的密碼重設為自動產生的新密碼。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
UnlockUser(String)	清除鎖定，以驗證使用者的成員資格。
UpdateUser(MembershipUser)	更新資料來源中的使用者相關資訊。
ValidateUser(String, String)	確認資料來源中存在指定的使用者名稱和密碼。

事件

ValidatingPassword

當建立使用者、變更密碼或重設密碼時發生。

另請參閱

• 實作成員資格提供者
• 成員資格簡介