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

指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。

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 信息服务 (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> 元素

membership 的 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