membership 項目 (ASP.NET 設定結構描述)

設定參數，以使用 ASP.NET 成員資格管理和驗證使用者帳戶。

這個項目是 .NET Framework 2.0 版中新增的項目。

<membership
    defaultProvider="provider name"
    userIsOnlineTimeWindow="number of minutes"
    hashAlgorithmType="SHA1">
    <providers>...</providers>
</membership>

屬性和項目

下列各節將說明屬性、子項目和父項目。

屬性

屬性	說明
defaultProvider	選擇性 String 屬性。 預設成員資格提供者的名稱。 如需詳細資訊，請參閱 Provider。 預設值為 AspNetSqlProvider。
userIsOnlineTimeWindow	選擇性 String 屬性。 指定使用者帳戶最後活動日期時間戳記之後的分鐘數，在此期間將使用者視為處於線上。 預設為 15 分鐘。
hashAlgorithmType	選擇性 String 屬性。 指定用於雜湊密碼值的加密演算法名稱。 這個 屬性的值會對應至 cryptoNameMapping 組態區段 nameEntry 項目中的 name 屬性。 如需指定自訂雜湊演算法的詳細資訊，請參閱將演算法名稱對應至密碼編譯類別。 預設值為 SHA1。

子項目

項目	說明
providers	選擇性項目。 定義成員資格提供者的集合。

父項目

項目	說明
configuration	指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中需要的根項目 (Root Element)。
system.web	指定 ASP.NET 組態區段的根項目。

備註

如需存取和修改應用程式程式碼中 membership 項目組態值的詳細資訊，請參閱 MembershipSection。

預設組態

下列預設 membership 項目是在 .NET Framework 2.0 版中的 Machine.config 檔案中設定。

<membership>
      <providers>
        <add name="AspNetSqlMembershipProvider" type="System.Web.Security.SqlMembershipProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" connectionStringName="LocalSqlServer" enablePasswordRetrieval="false" enablePasswordReset="true" requiresQuestionAndAnswer="true" applicationName="/" requiresUniqueEmail="false" passwordFormat="Hashed" maxInvalidPasswordAttempts="5" minRequiredPasswordLength="7" minRequiredNonalphanumericCharacters="1" passwordAttemptWindow="10" passwordStrengthRegularExpression="" />
      </providers>

</membership>

範例

下列程式碼範例將顯示如何將 ASP.NET 應用程式設定為使用 SqlMembershipProvider 提供者來儲存和擷取使用者帳戶資訊。

<configuration>
    <connectionStrings>
        <add name="SqlServices" 
             connectionString="Data Source=MySqlServer;Integrated Security=SSPI;Initial 
             Catalog=aspnetdb;" />
    </connectionStrings>
    <system.web>
        <membership 
             defaultProvider="SqlProvider"
             userIsOnlineTimeWindow="20">
             <providers>
                <remove name="AspNetSqlProvider" />
                <add name="SqlProvider"
                    type="System.Web.Security.SqlMembershipProvider"
                    connectionStringName="SqlServices"
                    enablePasswordRetrieval="false"
                    enablePasswordReset="true"
                    requiresQuestionAndAnswer="true"
                    passwordFormat="Hashed"
                    applicationName="/" />
            </providers>
        </membership>
    </system.web>
</configuration>

項目資訊

組態區段處理常式	System.Web.Configuration.MembershipSection
組態成員	Membership
可設定的位置	Machine.config 根層次的 Web.config 應用程式層級的 Web.config
需求	Microsoft Internet Information Services (IIS) 5.0、5.1 或 6.0 版 .NET Framework 2.0 版 Microsoft Visual Studio 2005

請參閱

工作

HOW TO：鎖定 ASP.NET 組態設定

參考

system.web 項目 (ASP.NET 設定結構描述)

<configuration> 項目

成員資格的 providers 項目 (ASP.NET 設定結構描述)

System.Configuration

System.Web.Configuration

概念

ASP.NET 組態概觀

ASP.NET Web 伺服器控制項和瀏覽器能力

保護 ASP.NET 組態

ASP.NET 組態案例

其他資源

使用成員資格管理使用者

ASP.NET 組態檔

ASP.NET 組態設定

一般組態設定 (ASP.NET)

ASP.NET 組態 API