共用方式為


FormsAuthenticationConfiguration 類別

定義

設定 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
繼承
FormsAuthenticationConfiguration

範例

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

注意 如果您使用 本節 credentials ,請務必遵循 ASP.NET 驗證中所述的指導方針。 為了獲得延展性和更佳的安全性,建議您使用外部資料庫來儲存使用者的認證。 如需建置安全 ASP.NET 應用程式的詳細資訊,請參閱保護您的 ASP.NET 應用程式和建置安全 ASP.NET 應用程式:驗證、授權和安全通訊

此範例使用SHA1。 由於 SHA1 的衝突問題,Microsoft 建議使用 SHA256。

<authentication mode="Forms">
  <forms name="MyAppCookie" loginUrl="login.aspx"
    defaultUrl="default.aspx"
    protection="Encryption" timeout="5" path="aspnetTest"
    slidingExpiration="false"
    cookieless="UseCookies" domain="domainName">
    <credentials passwordFormat="SHA1">
      <user name="aspnetuser1"
        password="5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8"/>
       <user name="aspnetuser2"
         password="E38AD214943DAAD1D64C102FAEC29DE4AFE9DA3D"/>
    </credentials>
  </forms>
</authentication>
// 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 可讓您以程式設計方式存取和修改 forms 組態 authentication 區段的 元素。

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

注意

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

建構函式

FormsAuthenticationConfiguration()

初始化 FormsAuthenticationConfiguration 類別的新執行個體。

屬性

Cookieless

取得或設定值,指出表單架構驗證是否該使用 Cookie 。

CookieSameSite

取得或設定 Cookie 的 SameSite 屬性值。

Credentials

取得使用者名稱和密碼的 FormsAuthenticationCredentials 集合。

CurrentConfiguration

取得最上層 Configuration 執行個體的參考,這個執行個體表示目前 ConfigurationElement 執行個體所屬的組態階層架構。

(繼承來源 ConfigurationElement)
DefaultUrl

取得或設定預設的 URL。

Domain

取得或設定要以表單驗證 Cookie 傳送的網域名稱。

ElementInformation

取得 ElementInformation 物件,其中包含 ConfigurationElement 物件之不可自訂的資訊和功能。

(繼承來源 ConfigurationElement)
ElementProperty

取得表示 ConfigurationElementProperty 物件本身的 ConfigurationElement 物件。

(繼承來源 ConfigurationElement)
EnableCrossAppRedirects

取得或設定值,指出已驗證使用者是否能重新導向至其他應用程式中的 URL。

EvaluationContext

取得 ConfigurationElement 物件的 ContextInformation 物件。

(繼承來源 ConfigurationElement)
HasContext

取得值,指出 CurrentConfiguration 屬性是否為 null

(繼承來源 ConfigurationElement)
Item[ConfigurationProperty]

取得或設定此組態項目的屬性 (Property) 或屬性 (Attribute)。

(繼承來源 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

取得或設定值,指出在傳輸驗證資訊時是否需要 Secure Sockets Layer (SSL) 連線。

SlidingExpiration

取得或設定驗證滑動期限。

TicketCompatibilityMode

取得或設定值,這個值表示要使用 Coordinated Universal Time (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)

取得值,指出在還原序列化程序中是否遇到未知的屬性 (Attribute)。

(繼承來源 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

取得值,指出在還原序列化程序中是否遇到未知的項目。

(繼承來源 ConfigurationElement)
OnRequiredPropertyNotFound(String)

在找不到必要的屬性時擲回例外狀況 (Exception)。

(繼承來源 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()

設定 IsReadOnly() 物件和所有子項目的 ConfigurationElement 屬性。

(繼承來源 ConfigurationElement)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

修改 ConfigurationElement 物件,以移除不應該儲存的所有值。

(繼承來源 ConfigurationElement)

適用於

另請參閱