CreatingCookieEventArgs Klasse

Definition

Namespace:

System.Web.ApplicationServices

Assembly:

System.Web.Extensions.dll

Stellt Daten für das CreatingCookie-Ereignis bereit.

public ref class CreatingCookieEventArgs : EventArgs

public class CreatingCookieEventArgs : EventArgs

type CreatingCookieEventArgs = class
    inherit EventArgs

Public Class CreatingCookieEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

CreatingCookieEventArgs

Beispiele

Das folgende Beispiel zeigt einen Ereignishandler für das CreatingCookie Ereignis. Der Handler ruft Benutzerwerte aus dem CreatingCookieEventArgs Objekt ab, um das Authentifizierungscookies anzupassen. Der Handler speichert den Wert aus der CustomCredential Eigenschaft im Authentifizierungsticket und legt die CookieIsSet Eigenschaft fest, um true anzugeben, dass das Authentifizierungscookies erstellt wurde.

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

Hinweise

Die CreatingCookieEventArgs Klasse stellt Werte für jeden CreatingCookie Ereignishandler bereit. Mithilfe der Eigenschaften dieser Klasse können Sie Benutzeranmeldeinformationen abrufen, wenn Sie ein benutzerdefiniertes Authentifizierungscookies erstellen.

Die AuthenticationService Klasse löst das CreatingCookie Ereignis aus, wenn das Authentifizierungscookies festgelegt wird, nachdem die Benutzeranmeldeinformationen authentifiziert wurden. Die AuthenticationService Klasse erstellt ein CreatingCookieEventArgs Objekt und übergibt es an einen beliebigen CreatingCookie Ereignishandler.

Sie rufen die Benutzeranmeldeinformationen über die UserNamePasswordEigenschaften und CustomCredential Eigenschaften ab. Die CustomCredential Eigenschaft kann alle benutzerdefinierten Werte enthalten, die Sie benötigen, um sich zu authentifizieren, z. B. eine Identifikationsnummer. Die IsPersistent Eigenschaft gibt an, ob das Authentifizierungscookies über die aktuelle Sitzung aufbewahrt werden soll. Legen Sie die CookieIsSet Eigenschaft fest true , wenn Sie das Authentifizierungscookies erstellen, damit die AuthenticationService Klasse das Cookie nicht erstellt.

Eigenschaften

CookieIsSet	Ruft Wert ab, der angibt, ob das Authentifizierungscookie erstellt wurde, oder legt diesen fest.
CustomCredential	Ruft zusätzliche, vom Benutzer bereitgestellte Authentifizierungswerte ab.
IsPersistent	Ruft einen Wert ab, der angibt, ob das Authentifizierungscookie über die aktuelle Sitzung hinaus beibehalten werden soll.
Password	Ruft das Kennwort für den Benutzer ab.
UserName	Ruft den Namen des Benutzers ab.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Siehe auch

• Windows Communication Foundation-Authentifizierungsdienst –Übersicht