AuthenticationSection 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
配置 Web 应用程序的身份验证。 此类不能被继承。
本文内容
public ref class AuthenticationSection sealed : System::Configuration::ConfigurationSection
public sealed class AuthenticationSection : System.Configuration.ConfigurationSection
type AuthenticationSection = class
inherit ConfigurationSection
Public NotInheritable Class AuthenticationSection
Inherits ConfigurationSection
继承
示例
本部分提供两个代码示例。 第一个演示了如何为节的 authentication
多个属性以声明方式指定值,该属性也可以作为类的成员 AuthenticationSection 进行访问。 第二个演示了如何使用 AuthenticationSection 类。
以下配置文件示例演示如何以声明方式为 authentication
节指定值。
备注
如果使用该credentials
部分,请务必遵循 ASP.NET 身份验证 中介绍的准则。 为了获得可伸缩性和更好的安全性,建议使用外部数据库来存储用户的凭据。
<authentication mode="Forms">
<forms name="MyAppCookieName" loginUrl="login.aspx">
<credentials passwordFormat="SHA1">
<user name="Kim"
password="07B7F3EE06F278DB966BE960E7CBBD103DF30CA6"/>
<user name="John"
password="BA56E5E0366D003E98EA1C7F04ABF8FCB3753889"/>
</credentials>
</forms>
</authentication>
此示例使用 SHA1。 由于与 SHA1 冲突,Microsoft 建议使用 SHA256。
下面的代码示例演示如何使用该 AuthenticationSection 类。
// Get the Web application configuration.
System.Configuration.Configuration configuration =
System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration(
"/aspnetTest");
// Get the section.
AuthenticationSection authenticationSection =
(AuthenticationSection)configuration.GetSection(
"system.web/authentication");
' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")
' Get the section.
Dim authenticationSection _
As AuthenticationSection = _
CType(configuration.GetSection( _
"system.web/authentication"), AuthenticationSection)
AuthenticationSection 类提供一种以编程方式访问和修改配置文件的 authentication
节的方法。
构造函数
属性
方法
DeserializeElement(XmlReader, Boolean)
从配置文件读取 XML。
(继承自 ConfigurationElement )
DeserializeSection(XmlReader)
从配置文件读取 XML。
(继承自 ConfigurationSection )
Equals(Object)
将当前的 ConfigurationElement 实例与指定的对象进行比较。
(继承自 ConfigurationElement )
GetHashCode()
获取表示当前 ConfigurationElement 实例的唯一值。
(继承自 ConfigurationElement )
GetRuntimeObject()
在派生的类中重写时返回自定义对象。
(继承自 ConfigurationSection )
GetTransformedAssemblyString(String)
返回指定程序集名称的转换版本。
(继承自 ConfigurationElement )
GetTransformedTypeString(String)
返回指定类型名称的转换版本。
(继承自 ConfigurationElement )
GetType()
获取当前实例的 Type 。
(继承自 Object )
Init()
将 ConfigurationElement 对象设置为其初始状态。
(继承自 ConfigurationElement )
InitializeDefault()
用于初始化 ConfigurationElement 对象的默认值集。
(继承自 ConfigurationElement )
IsModified()
指示自上次在派生类中实现此配置元素时保存或加载以来是否对其进行过修改。
(继承自 ConfigurationSection )
IsReadOnly()
获取一个值,该值指示 ConfigurationElement 对象是否为只读。
(继承自 ConfigurationElement )
ListErrors(IList)
将此 ConfigurationElement 对象以及所有子元素中无效属性的错误添加到传递的列表中。
(继承自 ConfigurationElement )
MemberwiseClone()
创建当前 Object 的浅表副本。
(继承自 Object )
OnDeserializeUnrecognizedAttribute(String, String)
获取一个值,该值指示反序列化过程中是否遇到未知特性。
(继承自 ConfigurationElement )
OnDeserializeUnrecognizedElement(String, XmlReader)
获取一个值,该值指示反序列化过程中是否遇到未知元素。
(继承自 ConfigurationElement )
OnRequiredPropertyNotFound(String)
找不到所需属性时引发异常。
(继承自 ConfigurationElement )
PostDeserialize()
反序列化后调用。
(继承自 ConfigurationElement )
PreSerialize(XmlWriter)
在序列化之前调用。
(继承自 ConfigurationElement )
Reset(ConfigurationElement)
重置 ConfigurationElement 对象的内部状态,包括锁和属性集合。
(继承自 ConfigurationElement )
ResetModified()
在派生类中实现时,将 IsModified() 方法的值重置为 false
。
(继承自 ConfigurationSection )
SerializeElement(XmlWriter, Boolean)
当在派生类中实现后,将此配置元素的内容写入配置文件。
(继承自 ConfigurationElement )
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)
创建一个包含 ConfigurationSection 对象的分离视图的 XML 字符串,作为单独的节写入到文件中。
(继承自 ConfigurationSection )
SerializeToXmlElement(XmlWriter, String)
当在派生类中实现后,将此配置元素的外部标记写入配置文件。
(继承自 ConfigurationElement )
SetPropertyValue(ConfigurationProperty, Object, Boolean)
将属性设置为指定值。
(继承自 ConfigurationElement )
SetReadOnly()
设置 ConfigurationElement 对象及所有子元素的 IsReadOnly() 属性。
(继承自 ConfigurationElement )
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)
指示当为指定目标版本的.NET Framework序列化配置对象层次结构时,是否应序列化指定的元素。
(继承自 ConfigurationSection )
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)
指示当为指定的目标版本的.NET Framework序列化配置对象层次结构时,是否应序列化指定的属性。
(继承自 ConfigurationSection )
ShouldSerializeSectionInTargetVersion(FrameworkName)
指示在为指定目标版本的.NET Framework序列化配置对象层次结构时,是否应序列化当前ConfigurationSection 实例。
(继承自 ConfigurationSection )
ToString()
返回表示当前对象的字符串。
(继承自 Object )
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)
修改 ConfigurationElement 对象以移除所有不应该保存的值。
(继承自 ConfigurationElement )
适用于
另请参阅