CreatingCookieEventArgs Classe

Definizione

Fornisce i dati per l'evento CreatingCookie.Provides data for the CreatingCookie event.

public ref class CreatingCookieEventArgs : EventArgs
public class CreatingCookieEventArgs : EventArgs
type CreatingCookieEventArgs = class
    inherit EventArgs
Public Class CreatingCookieEventArgs
Inherits EventArgs
Ereditarietà
CreatingCookieEventArgs

Esempio

Nell'esempio seguente viene illustrato un gestore eventi per l'evento CreatingCookie.The following example shows an event handler for the CreatingCookie event. Il gestore recupera i valori utente dall'oggetto CreatingCookieEventArgs per personalizzare il cookie di autenticazione.The handler retrieves user values from the CreatingCookieEventArgs object to customize the authentication cookie. Il gestore Salva il valore dalla proprietà CustomCredential nel ticket di autenticazione e imposta la proprietà CookieIsSet su true per indicare che il cookie di autenticazione è stato creato.The handler saves the value from the CustomCredential property in the authentication ticket and sets the CookieIsSet property to true to indicate that the authentication cookie has been created.

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

Commenti

La classe CreatingCookieEventArgs fornisce valori a qualsiasi gestore eventi CreatingCookie.The CreatingCookieEventArgs class supplies values to any CreatingCookie event handler. Utilizzando le proprietà di questa classe, è possibile recuperare le credenziali utente durante la creazione di un cookie di autenticazione personalizzato.By using the properties of this class, you can retrieve user credentials when you create a custom authentication cookie.

La classe AuthenticationService genera l'evento CreatingCookie quando imposta il cookie di autenticazione, dopo l'autenticazione delle credenziali utente.The AuthenticationService class raises the CreatingCookie event when it sets the authentication cookie, after the user credentials have been authenticated. La classe AuthenticationService costruisce un oggetto CreatingCookieEventArgs e lo passa a qualsiasi gestore eventi di CreatingCookie.The AuthenticationService class constructs a CreatingCookieEventArgs object and passes it to any CreatingCookie event handler.

Le credenziali utente vengono recuperate tramite il UserNamePassworde CustomCredential proprietà.You retrieve the user credentials through the UserNamePassword, and CustomCredential properties. La proprietà CustomCredential può contenere tutti i valori personalizzati necessari per l'autenticazione, ad esempio un numero di identificazione.The CustomCredential property can contain any custom values that you need in order to authenticate, such as an identification number. La proprietà IsPersistent indica se il cookie di autenticazione deve essere mantenuto oltre la sessione corrente.The IsPersistent property indicates whether the authentication cookie should be retained past the current session. Impostare la proprietà CookieIsSet su true se si crea il cookie di autenticazione, in modo che la classe AuthenticationService non crei il cookie.Set the CookieIsSet property to true if you create the authentication cookie, so that the AuthenticationService class does not create the cookie.

Proprietà

CookieIsSet

Ottiene o imposta un valore che indica se il cookie di autenticazione è stato creato.Gets or sets a value that indicates whether the authentication cookie has been created.

CustomCredential

Ottiene valori di autenticazione aggiuntivi forniti dall'utente.Gets additional authentication values that are provided by the user.

IsPersistent

Ottiene un valore che indica se il cookie di autenticazione deve essere mantenuto oltre la sessione corrente.Gets a value that indicates whether the authentication cookie should be retained beyond the current session.

Password

Ottiene la password per l'utente.Gets the password for the user.

UserName

Ottiene il nome per l'utente.Gets the name for the user.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche