MembershipProvider 類別

  • 參考

定義

命名空間:
System.Web.Security
組件:
System.Web.dll
組件:
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
衍生

備註

注意

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

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

適用於

另請參閱