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

定義

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

認証チケットを発行せずにユーザー資格情報を認証します。

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

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

返品

Boolean

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

属性
OperationContractAttribute

例外

ArgumentNullException

userName または password が null。

注釈

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

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

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

Note

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

適用対象

こちらもご覧ください