FormsAuthenticationCredentials 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
設定 ASP.NET 應用程式的使用者認證，該使用者認證使用表單型驗證。
public ref class FormsAuthenticationCredentials sealed : System::Configuration::ConfigurationElementpublic sealed class FormsAuthenticationCredentials : System.Configuration.ConfigurationElementtype FormsAuthenticationCredentials = class
inherit ConfigurationElementPublic NotInheritable Class FormsAuthenticationCredentials
Inherits ConfigurationElement- 繼承
範例
這個範例示範如何針對 區段的 credentials 數個屬性以宣告方式指定值，而這個屬性也可以當做 類別的成員 FormsAuthenticationCredentials 存取。
下列組態檔範例示範如何以宣告方式指定 credentials 區段的值。
<credentials passwordFormat="SHA1">
<user name="aspnetuser1"
password="5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8"/>
<user name="aspnetuser2"
password="E38AD214943DAAD1D64C102FAEC29DE4AFE9DA3D"/>
</credentials>
此範例使用 SHA1。 由於 SHA1 的衝突問題，Microsoft 建議使用 SHA256。
注意
如果您使用 本節 credentials ，請務必遵循ASP.NET 驗證中所述的指導方針。 為了獲得延展性和更佳的安全性，建議您使用外部資料庫來儲存使用者的認證。 如需建置安全 ASP.NET 應用程式的詳細資訊，請參閱保護您的 ASP.NET 應用程式和建置安全 ASP.NET 應用程式：驗證、授權和安全通訊。
下列程式碼範例示範如何使用 類別 FormsAuthenticationCredentials 。
// 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 forms credentials collection .
FormsAuthenticationCredentials formsAuthenticationCredentials =
authenticationSection.Forms.Credentials;
' Get the Web application configuration.
Dim configuration As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")
' Get the authentication section.
Dim authenticationSection _
As AuthenticationSection = _
CType(configuration.GetSection( _
"system.web/authentication"), AuthenticationSection)
' Get the forms credentials collection .
Dim formsAuthenticationCredentials _
As FormsAuthenticationCredentials = _
authenticationSection.Forms.Credentials
備註
類別 FormsAuthenticationCredentials 提供一種方式，以程式設計方式存取和修改 credentials 組態檔 區段中區段 authentication 的 元素 forms 。 此類型是包含 FormsAuthenticationConfiguration 、、 和 型別之群組的 FormsAuthenticationUserCollection FormsAuthenticationUser 一部分。 除了集合類型之外，所有其他專案都會直接影響基礎組態標記。
注意
FormsAuthenticationCredentials可以根據 所 MachineToApplication 定義的限制，將資訊寫入組態檔的相關區段中。 任何嘗試在階層中不允許的層級寫入組態檔，都會導致剖析器所產生的錯誤訊息。 不過，您可以使用這個類別來讀取階層中任何層級的組態資訊。 為了安全與延展性，建議您使用外部存放庫，例如資料庫來保留使用者的認證。
建構函式
| FormsAuthenticationCredentials() |
初始化 FormsAuthenticationCredentials 類別的新執行個體。 |