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 Authentifizierungscooky anzupassen. Der Handler speichert den Wert aus der CustomCredential -Eigenschaft im Authentifizierungsticket und legt die CookieIsSet -Eigenschaft auf fest, um true anzugeben, dass das Authentifizierungscooky 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 Authentifizierungscooky erstellen.

Die AuthenticationService -Klasse löst das CreatingCookie -Ereignis aus, wenn sie das Authentifizierungscooky festlegt, 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 ab. Die CustomCredential Eigenschaft kann alle benutzerdefinierten Werte enthalten, die Sie für die Authentifizierung benötigen, z. B. eine Identifikationsnummer. Die IsPersistent -Eigenschaft gibt an, ob das Authentifizierungscooky über die aktuelle Sitzung zurückgehalten werden soll. Legen Sie die CookieIsSet -Eigenschaft auf fest true , wenn Sie das Authentifizierungscooky 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)

Weitere Informationen

• Übersicht über den Windows Communication Foundation-Authentifizierungsdienst