AuthenticationService.ValidateUser(String, String, String) メソッド

定義

ユーザーの資格情報を認証しますが、認証チケットは作成しません。

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

パラメーター

username
String

妥当性を確認するユーザー名。

password
String

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

customCredential
String

usernamepassword 以外にも妥当性を確認する値があればその値。

戻り値

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

属性

例外

userName または passwordnull です。

注釈

メソッドは ValidateUser ユーザーの資格情報を認証しますが、認証 Cookie は設定しません。 認証 Cookie がない場合、資格情報が有効であっても、ユーザーはログインされません。

認証 Cookie を ValidateUser 受け取らずにユーザーの資格情報が有効かどうかを確認する必要がある場合は、 メソッドを使用します。 たとえば、認証 Cookie がクライアント アプリケーションに既に格納されているが、新しいセッションの開始時にユーザーの資格情報がまだ有効であることを確認する場合に、これを行うことができます。

メソッドは ValidateUser イベントを Authenticating 発生させますが、イベントは CreatingCookie 発生しません。

注意

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

適用対象

こちらもご覧ください