AuthenticationService.ValidateUser(String, String, String) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在不颁发身份验证票证的情况下对用户凭据进行身份验证。
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
之外的一个或多个值(如果有)。
返回
如果用户凭据有效,则为 true
;否则为 false
。
- 属性
例外
userName
或 password
为 null
。
注解
方法 ValidateUser 对用户凭据进行身份验证,但不设置身份验证 Cookie。 如果没有身份验证 Cookie,即使凭据有效,用户也不会登录。
ValidateUser当必须检查用户的凭据是否有效而不接收身份验证 Cookie 时,请使用 方法。 例如,如果身份验证 Cookie 已存储在客户端应用程序中,但你想要验证新会话启动时用户的凭据是否仍然有效,则可以执行此操作。
方法 ValidateUser 引发 Authenticating 事件,但不引发 CreatingCookie 事件。
注意
不要从在 Web 服务器上执行的代码调用 ValidateUser 方法。 仅作为 WCF 服务的一部分调用 ValidateUser 方法。 有关详细信息,请参阅 ASP.NET 身份验证。