AuthenticationService 類別

定義

命名空間:

System.Web.ApplicationServices

組件:

System.Web.Extensions.dll

允許使用 Web 服務存取 ASP.NET 表單驗證。

public ref class AuthenticationService

[System.ServiceModel.Activation.AspNetCompatibilityRequirements(RequirementsMode=System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode.Required)]
[System.ServiceModel.ServiceBehavior(ConcurrencyMode=System.ServiceModel.ConcurrencyMode.Multiple, InstanceContextMode=System.ServiceModel.InstanceContextMode.Single, Namespace="http://asp.net/ApplicationServices/v200")]
[System.ServiceModel.ServiceContract(Namespace="http://asp.net/ApplicationServices/v200")]
public class AuthenticationService

[<System.ServiceModel.Activation.AspNetCompatibilityRequirements(RequirementsMode=System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode.Required)>]
[<System.ServiceModel.ServiceBehavior(ConcurrencyMode=System.ServiceModel.ConcurrencyMode.Multiple, InstanceContextMode=System.ServiceModel.InstanceContextMode.Single, Namespace="http://asp.net/ApplicationServices/v200")>]
[<System.ServiceModel.ServiceContract(Namespace="http://asp.net/ApplicationServices/v200")>]
type AuthenticationService = class

Public Class AuthenticationService

繼承

Object

AuthenticationService

屬性

AspNetCompatibilityRequirementsAttribute ServiceBehaviorAttribute ServiceContractAttribute

備註

物件 AuthenticationService 可讓您透過 Windows Communication Foundation (WCF) 服務來驗證使用者。 當您必須透過儲存使用者認證的 Web 應用程式外部的應用程式，透過 ASP.NET 成員資格來驗證使用者時，請使用 WCF 驗證服務。 應用程式必須能夠以 SOAP 格式傳送和取用訊息。 透過 類別 AuthenticationService ，您可以登入、註銷使用者、驗證認證、檢查驗證狀態、自定義驗證，以及設定驗證 Cookie。

類別 AuthenticationService 包含四個方法，您只能透過 WCF 服務存取： IsLoggedIn、 Login、 Logout和 ValidateUser 方法。 若要呼叫這些方法，您可以在 Web 伺服器上啟用驗證服務，然後將 WCF 相容的用戶端應用程式連線到 Web 服務。 如需如何設定驗證服務的資訊，請參閱 如何：啟用WCF驗證服務。

若要登入使用者，請將使用者認證傳遞至 Login 方法。 如果認證有效，類別會 AuthenticationService 建立驗證 Cookie。 如果驗證 Cookie 尚未過期，您就會知道使用者的認證已經過驗證，而且您不需要再次驗證認證。 (無 Cookie 驗證無法透過 AuthenticationService class.)

AuthenticationService可以引發兩個事件： Authenticating 和 CreatingCookie。 驗證 Authenticating 使用者認證時，就會發生此事件。 建立 事件的事件處理程式 Authenticating ，以自定義使用者認證驗證的方式。 在 CreatingCookie 驗證使用者認證之後設定驗證 Cookie 時，就會發生此事件。 建立 事件的事件處理程式 CreatingCookie ，以自定義驗證 Cookie。

方法會 ValidateUser 檢查使用者認證以進行驗證，但不會傳回驗證票證。 當使用者 ValidateUser 先前已登入，而且您必須檢查認證在新的應用程式會話開始時是否仍然有效時使用。

如需從主控台應用程式使用 WCF 驗證服務的範例，請參閱逐步解說 ：使用 ASP.NET 應用程式服務。

建構函式

AuthenticationService()

初始化 AuthenticationService 類別的新執行個體。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsLoggedIn()	判斷目前的使用者是否已驗證。
Login(String, String, String, Boolean)	檢查使用者認證，如果認證有效，則建立驗證票證 (Cookie)。
Logout()	清除瀏覽器中的驗證票證 (Cookie)。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
ValidateUser(String, String, String)	驗證使用者認證，但不會發出驗證票證。

事件

Authenticating	會在驗證使用者認證時發生。
CreatingCookie	會在設定驗證 Cookie 時發生。

另請參閱

• Windows Communication Foundation 驗證服務概觀