Language

AuthenticationService.Login(String, String, String, Boolean) メソッド

定義

名前空間:
System.Web.ApplicationServices
アセンブリ:
System.Web.Extensions.dll

ユーザーの資格情報を確認し、資格情報が有効な場合は認証チケット (Cookie) を作成します。

public:
 bool Login(System::String ^ username, System::String ^ password, System::String ^ customCredential, bool isPersistent);
[System.ServiceModel.OperationContract]
public bool Login(string username, string password, string customCredential, bool isPersistent);
[<System.ServiceModel.OperationContract>]
member this.Login : string * string * string * bool -> bool
Public Function Login (username As String, password As String, customCredential As String, isPersistent As Boolean) As Boolean

パラメーター

username
String

検証するユーザー名。

password
String

指定したユーザーのパスワード。

customCredential
String

usernameとpasswordに加えて検証する値 (存在する場合)。

isPersistent
Boolean

認証チケットがセッション間で有効なままかどうかを示す値。

返品

Boolean

true ユーザー資格情報が有効な場合。それ以外の場合は false。

属性
OperationContractAttribute

例外

ArgumentNullException

userName または password が null。

注釈

Login メソッドは、メンバーシップ プロバイダーを介してユーザー資格情報を検証します。 既定のメンバーシップ プロバイダーを使用することも、実行時にカスタム メンバーシップ プロバイダーを指定することもできます。 AuthenticationService クラスは、メンバーシップ プロバイダーのuserName メソッドにpasswordとValidateUserを渡しますが、customCredentialを渡しません。 ValidateUserがtrueを返した場合、AuthenticationServiceは Cookie として認証チケットを作成します。 isPersistent パラメーターを true に設定して、現在のセッションを超えて続く認証チケットを作成します。

Note

機密データを保護するには、常に認証サービスをセキュリティで保護されたソケット レイヤー (SSL、HTTPS を使用) と共に使用します。

Login メソッドは、Authenticating イベントとCreatingCookie イベントを発生させます。 Authenticatingの値の確認や既定以外のメンバーシップ プロバイダーによる資格情報の検証など、認証をカスタマイズするcustomCredentialのイベント ハンドラーを作成します。 customCredentialの値は、既定のメンバーシップ プロバイダーでは検証されません。 認証 Cookie をカスタマイズするには、 CreatingCookieのイベント ハンドラーを作成します。

Note

Web サーバーで実行されているコードから Login メソッドを呼び出さないでください。 Login メソッドは、WCF サービスの一部としてのみ呼び出します。 詳細については、「ASP.NET 認証」を参照してください。

適用対象

こちらもご覧ください