FormsAuthenticationConfiguration 類別

定義

命名空間:

System.Web.Configuration

組件:

System.Web.dll

設定 ASP.NET 應用程式以使用 AuthenticationMode 表單形式。

public ref class FormsAuthenticationConfiguration sealed : System::Configuration::ConfigurationElement

public sealed class FormsAuthenticationConfiguration : System.Configuration.ConfigurationElement

type FormsAuthenticationConfiguration = class
    inherit ConfigurationElement

Public NotInheritable Class FormsAuthenticationConfiguration
Inherits ConfigurationElement

繼承

Object

ConfigurationElement

FormsAuthenticationConfiguration

範例

下列程式代碼範例示範如何從現有 Web 應用程式的組態檔取得 FormsAuthenticationConfiguration 物件。 您可以使用這個物件來存取其成員。

// Get the Web application configuration.
System.Configuration.Configuration configuration =
    WebConfigurationManager.OpenWebConfiguration("/aspnetTest");

// Get the external Authentication section.
AuthenticationSection authenticationSection =
    (AuthenticationSection)configuration.GetSection(
    "system.web/authentication");

// Get the external Forms section .
FormsAuthenticationConfiguration formsAuthentication =
    authenticationSection.Forms;

' Get the Web application configuration.
Dim configuration As System.Configuration.Configuration =
WebConfigurationManager.OpenWebConfiguration(
"/aspnetTest")

' Get the external Authentication section.
Dim authenticationSection _
As AuthenticationSection =
CType(configuration.GetSection(
"system.web/authentication"), AuthenticationSection)

' Get the external Forms section .
Dim formsAuthentication _
As FormsAuthenticationConfiguration =
authenticationSection.Forms

備註

FormsAuthenticationConfiguration 類別提供一種方式，以程式設計方式存取和修改組態 authentication 區段的 forms 專案。

此類型是包含 FormsAuthenticationCredentials、FormsAuthenticationUserCollection和 FormsAuthenticationUser 型別的群組的一部分。 集合類型以外的類型直接影響基礎組態標記。

警告

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

注意

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

建構函式

FormsAuthenticationConfiguration()

初始化 FormsAuthenticationConfiguration 類別的新實例。

屬性

Cookieless	取得或設定值，指出窗體型驗證是否應該使用 Cookie。
CookieSameSite	取得或設定 Cookie 的 SameSite 屬性值。
Credentials	取得使用者名稱和密碼 FormsAuthenticationCredentials 集合。
CurrentConfiguration	取得最上層 Configuration 實例的參考，表示目前 ConfigurationElement 實例所屬的組態階層。 (繼承來源 ConfigurationElement)
DefaultUrl	取得或設定預設 URL。
Domain	取得或設定要以窗體驗證Cookie傳送的功能變數名稱。
ElementInformation	取得 ElementInformation 物件，其中包含 ConfigurationElement 物件的不可自定義資訊和功能。 (繼承來源 ConfigurationElement)
ElementProperty	取得代表 ConfigurationElement 物件本身的 ConfigurationElementProperty 物件。 (繼承來源 ConfigurationElement)
EnableCrossAppRedirects	取得或設定值，指出已驗證的使用者是否可以重新導向至其他應用程式中的URL。
EvaluationContext	取得 ConfigurationElement 物件的 ContextInformation 物件。 (繼承來源 ConfigurationElement)
HasContext	取得值，這個值表示 CurrentConfiguration 屬性是否 null。 (繼承來源 ConfigurationElement)
Item[ConfigurationProperty]	取得或設定這個組態項目的屬性或屬性。 (繼承來源 ConfigurationElement)
Item[String]	取得或設定這個組態專案的屬性、屬性或子專案。 (繼承來源 ConfigurationElement)
LockAllAttributesExcept	取得鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockAllElementsExcept	取得鎖定專案的集合。 (繼承來源 ConfigurationElement)
LockAttributes	取得鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockElements	取得鎖定專案的集合。 (繼承來源 ConfigurationElement)
LockItem	取得或設定值，指出專案是否已鎖定。 (繼承來源 ConfigurationElement)
LoginUrl	取得或設定要求的重新導向 URL。
Name	取得或設定 Cookie 名稱。
Path	取得或設定 Cookie 路徑。
Properties	取得屬性的集合。 (繼承來源 ConfigurationElement)
Protection	取得或設定用來加密 Cookie 的加密類型。
RequireSSL	取得或設定值，指出傳輸驗證資訊時是否需要安全套接字層 （SSL） 連線。
SlidingExpiration	取得或設定驗證滑動到期日。
TicketCompatibilityMode	取得或設定值，這個值表示票證到期日是否要使用國際標準時間 （UTC） 或當地時間。
Timeout	取得或設定驗證逾時。

方法

DeserializeElement(XmlReader, Boolean)	從組態檔讀取 XML。 (繼承來源 ConfigurationElement)
Equals(Object)	比較目前 ConfigurationElement 實例與指定的物件。 (繼承來源 ConfigurationElement)
GetHashCode()	取得代表目前 ConfigurationElement 實例的唯一值。 (繼承來源 ConfigurationElement)
GetTransformedAssemblyString(String)	傳回所指定元件名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetTransformedTypeString(String)	傳回指定之型別名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
Init()	將 ConfigurationElement 物件設定為其初始狀態。 (繼承來源 ConfigurationElement)
InitializeDefault()	用來初始化 ConfigurationElement 物件的預設值集。 (繼承來源 ConfigurationElement)
IsModified()	指出在衍生類別中實作時，自上次儲存或載入此組態項目之後，是否已修改此組態專案。 (繼承來源 ConfigurationElement)
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。 (繼承來源 ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	在衍生類別中實作時，將此組態專案的內容寫入組態檔。 (繼承來源 ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	在衍生類別中實作時，將此組態專案的外部標記寫入組態檔。 (繼承來源 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	將屬性設定為指定的值。 (繼承來源 ConfigurationElement)
SetReadOnly()	設定 ConfigurationElement 物件和所有子元素的 IsReadOnly() 屬性。 (繼承來源 ConfigurationElement)
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	修改 ConfigurationElement 物件，移除不應儲存的所有值。 (繼承來源 ConfigurationElement)