FormsAuthenticationConfiguration 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
設定 ASP.NET 應用程式以使用 AuthenticationMode 表單強制回應性。
public ref class FormsAuthenticationConfiguration sealed : System::Configuration::ConfigurationElementpublic sealed class FormsAuthenticationConfiguration : System.Configuration.ConfigurationElementtype FormsAuthenticationConfiguration = class
inherit ConfigurationElementPublic NotInheritable Class FormsAuthenticationConfiguration
Inherits ConfigurationElement- 繼承
範例
下列程式碼範例示範如何從現有 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 、、 和 型別之群組的 FormsAuthenticationUserCollection FormsAuthenticationUser 一部分。 集合類型以外的類型會直接影響基礎組態標記。
注意
FormsAuthenticationConfiguration可以根據區段屬性 AllowDefinition 所定義的限制，將資訊寫入組態檔的相關區段中，其值為 MachineToApplication 。 任何嘗試在階層中不允許的層級寫入組態檔，都會導致剖析器所產生的錯誤訊息。 不過，您可以使用這個類別來讀取階層中任何層級的組態資訊。 為了安全與延展性，建議您使用外部存放庫，例如資料庫來保留使用者的認證。
建構函式
| FormsAuthenticationConfiguration() |
初始化 FormsAuthenticationConfiguration 類別的新執行個體。 |