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 時擷取用戶認證。

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

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

屬性

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

方法

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

另請參閱

• Windows Communication Foundation 驗證服務概觀