FormsAuthenticationUser 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
为使用基于窗体验证的 Web 应用程序配置用户凭据。
public ref class FormsAuthenticationUser sealed : System::Configuration::ConfigurationElement
public sealed class FormsAuthenticationUser : System.Configuration.ConfigurationElement
type FormsAuthenticationUser = class
inherit ConfigurationElement
Public NotInheritable Class FormsAuthenticationUser
Inherits ConfigurationElement
- 继承
示例
下面的代码示例演示如何获取 FormsAuthenticationUserCollection 以访问 FormsAuthenticationUser 现有 Web 应用程序的对象。 配置文件将包含如下所示的设置。
注意
如果使用 凭据元素表单进行身份验证 (ASP.NET 设置架构) 部分,请务必遵循 ASP.NET 身份验证中所述的准则。 为了提高可伸缩性和更好的安全性,建议使用外部数据库来存储用户的凭据。 有关生成安全 ASP.NET 应用程序的详细信息,请参阅保护 ASP.NET 应用程序和构建安全的 ASP.NET 应用程序:身份验证、授权和安全通信。
此示例使用 SHA1。 由于与 SHA1 冲突,Microsoft 建议使用 SHA256。
<authentication mode="Forms">
<forms name="MyAppCookieName" loginUrl="/login.aspx">
defaultUrl="formsdefault.aspx"
protection="Encryption" timeout="5" path="aspnet"
slidingExpiration="false"
cookieless="UseCookies" domain="domainName">
<credentials passwordFormat="SHA1">
<user name="aspnetuser1"
password="5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8"/>
<user name="aspnetuser2"
password="E38AD214943DAAD1D64C102FAEC29DE4AFE9DA3D"/>
</credentials>
</forms>
</authentication>
// Get the Web application configuration.
System.Configuration.Configuration configuration =
WebConfigurationManager.OpenWebConfiguration(
"/aspnet");
// Get the section.
AuthenticationSection authenticationSection =
(AuthenticationSection)configuration.GetSection(
"system.web/authentication");
// Get the users collection.
FormsAuthenticationUserCollection formsAuthenticationUsers =
authenticationSection.Forms.Credentials.Users;
' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnet")
' Get the section.
Dim authenticationSection _
As AuthenticationSection = _
CType(configuration.GetSection( _
"system.web/authentication"), AuthenticationSection)
' Get the users collection.
Dim formsAuthenticationUsers _
As FormsAuthenticationUserCollection = _
authenticationSection.Forms.Credentials.Users
注解
类 FormsAuthenticationUser 提供了一种以编程方式访问和修改配置文件 的表单身份验证部分的凭据元素 的方法。
此类型是包含 FormsAuthenticationCredentials、 FormsAuthenticationUserCollection和 类型的组的 FormsAuthenticationConfiguration 一部分。 集合类型以外的类型直接影响基础配置标记。
注意
FormsAuthenticationUser只能在计算机、站点或应用程序级别将信息写入配置文件的相关部分。 在层次结构中不同级别的配置文件中写入的任何尝试都将导致分析程序生成的错误消息。 但是,可以使用此类读取层次结构中任何级别的配置信息。 为了保证安全性和可伸缩性,建议使用外部存储库(如数据库)来保留用户的凭据。
构造函数
FormsAuthenticationUser(String, String) |
使用传递的参数初始化 FormsAuthenticationUser 类的新实例。 |