FormsAuthenticationUser 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
對使用表單型驗證的 Web 應用程式，設定使用者的認證。
public ref class FormsAuthenticationUser sealed : System::Configuration::ConfigurationElementpublic sealed class FormsAuthenticationUser : System.Configuration.ConfigurationElementtype FormsAuthenticationUser = class
inherit ConfigurationElementPublic NotInheritable Class FormsAuthenticationUser
Inherits ConfigurationElement- 繼承
範例
下列程式代碼範例示範如何取得 FormsAuthenticationUserCollection 以存取 FormsAuthenticationUser 現有 Web 應用程式物件的 。 組態檔將包含類似下列的安裝程式。
注意
如果您使用 認證元素進行窗體驗證 (ASP.NET 設定架構) 一節，請務必遵循 ASP.NET 驗證中所述的指導方針。 為了獲得延展性和更佳的安全性，建議您使用外部資料庫來儲存使用者的認證。 如需建置安全 ASP.NET 應用程式的詳細資訊，請參閱保護您的 ASP.NET 應用程式和建置安全 ASP.NET 應用程式：驗證、授權和安全通訊。
此範例使用SHA1。 由於 SHA1 的衝突問題，Microsoft 建議使用 SHA256。
<authentication mode="Forms">
<forms name="MyAppCookieName" loginUrl="/login.aspx">
defaultUrl="formsdefault.aspx"
protection="Encryption" timeout="5" path="aspnet"
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(
"/aspnet");
// Get the section.
AuthenticationSection authenticationSection =
(AuthenticationSection)configuration.GetSection(
"system.web/authentication");
// Get the users collection.
FormsAuthenticationUserCollection formsAuthenticationUsers =
authenticationSection.Forms.Credentials.Users;
' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnet")
' Get the section.
Dim authenticationSection _
As AuthenticationSection = _
CType(configuration.GetSection( _
"system.web/authentication"), AuthenticationSection)
' Get the users collection.
Dim formsAuthenticationUsers _
As FormsAuthenticationUserCollection = _
authenticationSection.Forms.Credentials.Users
備註
類別 FormsAuthenticationUser 提供一種方式，以程式設計方式存取和修改組態檔驗證 區段之表單的認證專案 。
此類型是包含FormsAuthenticationCredentials、、 和 型別之群組的FormsAuthenticationUserCollectionFormsAuthenticationConfiguration一部分。 集合類型以外的類型會直接影響基礎組態標記。
注意
FormsAuthenticationUser只能在計算機、月臺或應用層級將資訊寫入組態檔的相關區段。 任何嘗試在階層中位於不同層級的組態檔中寫入，都會導致剖析器所產生的錯誤訊息。 不過，您可以使用這個類別來讀取階層中任何層級的組態資訊。 為了安全與延展性，建議您使用外部存放庫，例如資料庫來保留用戶的認證。
建構函式
| FormsAuthenticationUser(String, String) |
使用傳遞的參數，初始化 FormsAuthenticationUser 類別的新執行個體。 |
