AuthenticationSection 類別

定義

命名空間:

System.Web.Configuration

組件:

System.Web.dll

設定 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

繼承

Object

ConfigurationElement

ConfigurationSection

AuthenticationSection

範例

此範例示範如何使用 AuthenticationSection 類別。

// 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 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)

警告

在 [credentials] 區段中儲存使用者認證 不安全。 請改用 Azure Key Vault。

備註

AuthenticationSection 類別可讓您以程序設計方式存取和修改組態檔的 authentication 區段。

注意

AuthenticationSection 可以根據區段屬性所定義的限制，將資訊寫入組態檔的相關區段，AllowDefinition 其值為 MachineToApplication。 在階層中不允許層級的組態檔中寫入的任何嘗試，都會導致剖析器所產生的錯誤訊息。 不過，您可以使用這個類別來讀取階層中任何層級的組態資訊。 為了安全與延展性，建議您使用外部存放庫，例如資料庫來保留用戶的認證。

建構函式

AuthenticationSection()

初始化 AuthenticationSection 類別的新實例。

屬性

CurrentConfiguration	取得最上層 Configuration 實例的參考，表示目前 ConfigurationElement 實例所屬的組態階層。 (繼承來源 ConfigurationElement)
ElementInformation	取得 ElementInformation 物件，其中包含 ConfigurationElement 物件的不可自定義資訊和功能。 (繼承來源 ConfigurationElement)
ElementProperty	取得代表 ConfigurationElement 物件本身的 ConfigurationElementProperty 物件。 (繼承來源 ConfigurationElement)
EvaluationContext	取得 ConfigurationElement 物件的 ContextInformation 物件。 (繼承來源 ConfigurationElement)
Forms	取得項目屬性 Forms。
HasContext	取得值，這個值表示 CurrentConfiguration 屬性是否 null。 (繼承來源 ConfigurationElement)
Item[ConfigurationProperty]	取得或設定這個組態項目的屬性或屬性。 (繼承來源 ConfigurationElement)
Item[String]	取得或設定這個組態專案的屬性、屬性或子專案。 (繼承來源 ConfigurationElement)
LockAllAttributesExcept	取得鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockAllElementsExcept	取得鎖定專案的集合。 (繼承來源 ConfigurationElement)
LockAttributes	取得鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockElements	取得鎖定專案的集合。 (繼承來源 ConfigurationElement)
LockItem	取得或設定值，指出專案是否已鎖定。 (繼承來源 ConfigurationElement)
Mode	取得或設定驗證方式。
Passport	已淘汰. 取得項目屬性 Passport。
Properties	取得屬性的集合。 (繼承來源 ConfigurationElement)
SectionInformation	取得 SectionInformation 物件，其中包含 ConfigurationSection 物件不可自定義的資訊和功能。 (繼承來源 ConfigurationSection)

方法

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)	建立 XML 字串，其中包含 ConfigurationSection 物件的未合併檢視，做為要寫入檔案的單一區段。 (繼承來源 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)

另請參閱

• FormsAuthenticationConfiguration
• PassportAuthentication
• ASP.NET 驗證