CreatingCookieEventArgs Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Udostępnia dane dla zdarzenia CreatingCookie.
public ref class CreatingCookieEventArgs : EventArgs
public class CreatingCookieEventArgs : EventArgs
type CreatingCookieEventArgs = class
inherit EventArgs
Public Class CreatingCookieEventArgs
Inherits EventArgs
- Dziedziczenie
Przykłady
W poniższym przykładzie przedstawiono procedurę obsługi zdarzeń dla CreatingCookie zdarzenia. Program obsługi pobiera wartości użytkownika z obiektu w CreatingCookieEventArgs celu dostosowania pliku cookie uwierzytelniania. Program obsługi zapisuje wartość z CustomCredential właściwości w bilecie uwierzytelniania i ustawia CookieIsSet właściwość na wartość , aby wskazać true
, że plik cookie uwierzytelniania został utworzony.
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
Uwagi
Klasa CreatingCookieEventArgs dostarcza wartości do dowolnej CreatingCookie procedury obsługi zdarzeń. Za pomocą właściwości tej klasy można pobrać poświadczenia użytkownika podczas tworzenia niestandardowego pliku cookie uwierzytelniania.
Klasa AuthenticationService zgłasza CreatingCookie zdarzenie po ustawieniu pliku cookie uwierzytelniania po uwierzytelnieniu poświadczeń użytkownika. Klasa AuthenticationService tworzy CreatingCookieEventArgs obiekt i przekazuje go do dowolnej CreatingCookie procedury obsługi zdarzeń.
Poświadczenia użytkownika są pobierane za pomocą UserNamePasswordwłaściwości i CustomCredential . Właściwość CustomCredential może zawierać dowolne wartości niestandardowe potrzebne do uwierzytelniania, takie jak numer identyfikacyjny. Właściwość IsPersistent wskazuje, czy plik cookie uwierzytelniania powinien być zachowywany poza bieżącą sesją.
CookieIsSet Ustaw właściwość na true
wartość , jeśli tworzysz plik cookie uwierzytelniania, aby AuthenticationService klasa nie utworzyła pliku cookie.
Właściwości
CookieIsSet |
Pobiera lub ustawia wartość wskazującą, czy plik cookie uwierzytelniania został utworzony. |
CustomCredential |
Pobiera dodatkowe wartości uwierzytelniania udostępniane przez użytkownika. |
IsPersistent |
Pobiera wartość wskazującą, czy plik cookie uwierzytelniania powinien zostać zachowany poza bieżącą sesją. |
Password |
Pobiera hasło użytkownika. |
UserName |
Pobiera nazwę użytkownika. |
Metody
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |