CreatingCookieEventArgs 類別

定義

命名空間:

System.Web.ApplicationServices

組件:

System.Web.Extensions.dll

提供 CreatingCookie 事件的資料。

public ref class CreatingCookieEventArgs : EventArgs

public class CreatingCookieEventArgs : EventArgs

type CreatingCookieEventArgs = class
    inherit EventArgs

Public Class CreatingCookieEventArgs
Inherits EventArgs

繼承

Object

EventArgs

CreatingCookieEventArgs

範例

下列範例顯示 事件的事件處理常式 CreatingCookie 。 處理常式會從 物件擷 CreatingCookieEventArgs 取使用者值，以自訂驗證 Cookie。 處理常式會將 來自 屬性的值 CustomCredential 儲存在驗證票證中，並將 屬性設定 CookieIsSet 為 true ，以指出已建立驗證 Cookie。

void AuthenticationService_CreatingCookie(object sender, 
    System.Web.ApplicationServices.CreatingCookieEventArgs e)
{
    FormsAuthenticationTicket ticket = new
          FormsAuthenticationTicket
            (1,
             e.UserName,
             DateTime.Now,
             DateTime.Now.AddMinutes(30),
             e.IsPersistent,
             e.CustomCredential,
             FormsAuthentication.FormsCookiePath);

    string encryptedTicket =
         FormsAuthentication.Encrypt(ticket);

    HttpCookie cookie = new HttpCookie
         (FormsAuthentication.FormsCookieName,
          encryptedTicket);
    cookie.Expires = DateTime.Now.AddMinutes(30);

    HttpContext.Current.Response.Cookies.Add(cookie);
    e.CookieIsSet = true;
}

Sub AuthenticationService_CreatingCookie(ByVal sender As Object, _
                 ByVal e As System.Web.ApplicationServices.CreatingCookieEventArgs)
    Dim ticket As FormsAuthenticationTicket = New _
       FormsAuthenticationTicket _
        (1, _
         e.Username, _
         DateTime.Now, _
         DateTime.Now.AddMinutes(30), _
         e.IsPersistent, _
         e.CustomCredential, _
         FormsAuthentication.FormsCookiePath)
        
    Dim encryptedTicket As String = FormsAuthentication.Encrypt(ticket)
    
    Dim cookie As HttpCookie = New _
        HttpCookie(FormsAuthentication.FormsCookieName, encryptedTicket)
    cookie.Expires = DateTime.Now.AddMinutes(30)
    
    HttpContext.Current.Response.Cookies.Add(cookie)
    e.CookieIsSet = True
End Sub

備註

類別 CreatingCookieEventArgs 會將值提供給任何 CreatingCookie 事件處理常式。 藉由使用這個類別的屬性，您可以在建立自訂驗證 Cookie 時擷取使用者認證。

CreatingCookie類別 AuthenticationService 會在使用者認證通過驗證之後，設定驗證 Cookie 時引發 事件。 類別 AuthenticationService 會 CreatingCookieEventArgs 建構 物件，並將它傳遞至任何 CreatingCookie 事件處理常式。

您可以透過 和 CustomCredential 屬性擷 UserNamePassword 取使用者認證。 屬性 CustomCredential 可以包含您需要的任何自訂值，例如識別碼。 屬性 IsPersistent 會指出驗證 Cookie 是否應該保留超過目前的會話。 CookieIsSet如果您建立驗證 Cookie，請將 屬性設定為 true ，讓 AuthenticationService 類別不會建立 Cookie。

屬性

CookieIsSet	取得或設定值，表示是否已建立驗證 Cookie。
CustomCredential	取得使用者所提供的其他驗證值。
IsPersistent	取得值，指出驗證 Cookie 是否應保留至目前工作階段以後。
Password	取得使用者的密碼。
UserName	取得使用者的名稱。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• Windows Communication Foundation 驗證服務概觀