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 和 password 以外要驗證的值 (如果有的話)。

Boolean

如果使用者認證有效則為 true，否則為 false。

userName 或 password 為 null。

方法 ValidateUser 會驗證用戶認證，但不會設定驗證 Cookie。如果沒有驗證 Cookie，即使認證有效，使用者也不會登入。

ValidateUser當您必須檢查使用者的認證是否有效，而不收到驗證 Cookie 時，請使用方法。例如，如果驗證 Cookie 已儲存在用戶端應用程式中，但您想要確認使用者認證在新的工作階段啟動時仍然有效，您可能會這麼做。

方法 ValidateUser 會 Authenticating 引發事件，但不會引發 CreatingCookie 事件。

注意

請勿從 Web 伺服器上執行的程式代碼呼叫 ValidateUser 方法。您只會呼叫 ValidateUser 方法做為 WCF 服務的一部分。如需詳細資訊，請參閱 ASP.NET 驗證。