共用方式為


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: Lock ASP.NET Configuration Settings

參考

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

<configuration> 項目

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

System.Configuration

System.Web.Configuration

概念

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

其他資源

Managing Users Using ASP.NET Membership

ASP.NET Configuration Files

ASP.NET 組態設定

一般組態設定 (ASP.NET)

ASP.NET Configuration API