FormsAuthenticationCredentials 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
为使用基于表单的身份验证的 ASP.NET 应用程序配置用户凭据。
public ref class FormsAuthenticationCredentials sealed : System::Configuration::ConfigurationElementpublic sealed class FormsAuthenticationCredentials : System.Configuration.ConfigurationElementtype FormsAuthenticationCredentials = class
inherit ConfigurationElementPublic NotInheritable Class FormsAuthenticationCredentials
Inherits ConfigurationElement- 继承
示例
此示例演示如何为节的 credentials 多个属性以声明方式指定值，该属性也可以作为类的成员 FormsAuthenticationCredentials 进行访问。
以下配置文件示例演示如何以声明方式为 credentials 节指定值。
<credentials passwordFormat="SHA1">
<user name="aspnetuser1"
password="5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8"/>
<user name="aspnetuser2"
password="E38AD214943DAAD1D64C102FAEC29DE4AFE9DA3D"/>
</credentials>
此示例使用 SHA1。 由于与 SHA1 冲突，Microsoft 建议使用 SHA256。
备注
如果使用该credentials部分，请务必遵循 ASP.NET 身份验证中介绍的准则。 为了获得可伸缩性和更好的安全性，建议使用外部数据库来存储用户的凭据。 有关生成安全 ASP.NET 应用程序的详细信息，请参阅保护 ASP.NET 应用程序和生成安全 ASP.NET 应用程序：身份验证、授权和安全通信。
下面的代码示例演示如何使用该 FormsAuthenticationCredentials 类。
// Get the Web application configuration.
System.Configuration.Configuration configuration =
WebConfigurationManager.OpenWebConfiguration("/aspnetTest");
// Get the authentication section.
AuthenticationSection authenticationSection =
(AuthenticationSection)configuration.GetSection(
"system.web/authentication");
// Get the forms credentials collection .
FormsAuthenticationCredentials formsAuthenticationCredentials =
authenticationSection.Forms.Credentials;
' Get the Web application configuration.
Dim configuration As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")
' Get the authentication section.
Dim authenticationSection _
As AuthenticationSection = _
CType(configuration.GetSection( _
"system.web/authentication"), AuthenticationSection)
' Get the forms credentials collection .
Dim formsAuthenticationCredentials _
As FormsAuthenticationCredentials = _
authenticationSection.Forms.Credentials
注解
该FormsAuthenticationCredentials类提供了一种以编程方式访问和修改credentials配置文件节中authentication节的元素forms的方法。 此类型是包含 FormsAuthenticationConfiguration、类型和 FormsAuthenticationUserCollection类型的组的 FormsAuthenticationUser 一部分。 除了集合类型之外，所有其他项都直接影响基础配置标记。
备注
可以根据 FormsAuthenticationCredentials 配置文件 MachineToApplication定义的限制将信息写入配置文件的相关部分。 在层次结构中不允许的级别写入配置文件的任何尝试都将导致分析器生成的错误消息。 但是，可以使用此类在层次结构中的任何级别读取配置信息。 为了安全和可伸缩性，建议使用外部存储库（如数据库）来保留用户的凭据。
构造函数
| FormsAuthenticationCredentials() |
初始化 FormsAuthenticationCredentials 类的新实例。 |