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- 継承
例
次のコード例は、既存の Web アプリケーションの FormsAuthenticationUserCollection オブジェクトにアクセス FormsAuthenticationUser する方法を示しています。 構成ファイルには、次のようなセットアップが含まれます。
注意
認証用のフォームに credentials 要素 (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 クラスの新しいインスタンスを初期化します。 |