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 类的新实例。 |
