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>
元素信息
配置节处理程序 |
|
配置成员 |
|
可配置的位置 |
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
参考
membership 的 providers 元素(ASP.NET 设置架构)
概念
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities