CreatingCookieEventArgs.IsPersistent Eigenschaft

Referenz

Definition

Namespace:: System.Web.ApplicationServices

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der angibt, ob das Authentifizierungscookie über die aktuelle Sitzung hinaus beibehalten werden soll.

public:
 property bool IsPersistent { bool get(); };

public bool IsPersistent { get; }

member this.IsPersistent : bool

Public ReadOnly Property IsPersistent As Boolean

Eigenschaftswert

Boolean

true, wenn das Cookie über die aktuelle Sitzung hinaus beibehalten werden soll, andernfalls false.

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. Die IsPersistent -Eigenschaft des FormsAuthenticationTicket -Objekts wird auf den Wert in der IsPersistent -Eigenschaft festgelegt.

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

Wenn Sie ein FormsAuthenticationTicket -Objekt erstellen, können Sie die IsPersistent -Eigenschaft verwenden, um anzugeben, ob das Authentifizierungscookies über die aktuelle Sitzung hinaus beibehalten wird.

Gilt für:

Freigeben über