Cette documentation est archivée et n’est pas conservée.

HttpCookie, classe

Mise à jour : novembre 2007

Fournit une manière sécurisée de créer et manipuler des cookies HTTP.

Espace de noms :  System.Web
Assembly :  System.Web (dans System.Web.dll)

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class HttpCookie
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public final class HttpCookie
public final class HttpCookie

La classe HttpCookie obtient et définit les propriétés de cookies individuels. La classe HttpCookieCollection fournit des méthodes pour stocker, récupérer et gérer plusieurs cookies.

ASP.NET comprend deux collections de cookies intrinsèques. La collection obtenue par le biais de la collection Cookies de l'objet HttpRequest contient des cookies transmis au client par le serveur dans l'en-tête Cookie. La collection obtenue par le biais de la collection Cookies de l'objet HttpResponse contient de nouveaux cookies créés sur le serveur et transmis au client dans l'en-tête de réponse HTTP Set-Cookie.

TopicLocation
Comment : écrire un cookieGénération d'applications Web ASP.NET dans Visual Studio
Comment : écrire un cookieGénération d'applications Web ASP.NET dans Visual Studio
Comment : écrire un cookieGénération d'applications Web ASP.NET

L'exemple de code suivant montre comment rechercher un cookie nommé DateCookieExample dans l'objet HttpRequest. Si le cookie est introuvable, il est créé et ajouté à l'objet HttpResponse. Le cookie est configuré pour expirer dans les 10 minutes.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Page_Load(object sender, EventArgs e)
    {
        StringBuilder sb = new StringBuilder();
        // Get cookie from the current request.
        HttpCookie cookie = Request.Cookies.Get("DateCookieExample");

        // Check if cookie exists in the current request.
        if (cookie == null)
        {
            sb.Append("Cookie was not received from the client. ");
            sb.Append("Creating cookie to add to the response. <br/>");
            // Create cookie.
            cookie = new HttpCookie("DateCookieExample");
            // Set value of cookie to current date time.
            cookie.Value = DateTime.Now.ToString();
            // Set cookie to expire in 10 minutes.
            cookie.Expires = DateTime.Now.AddMinutes(10d);
            // Insert the cookie in the current HttpResponse.
            Response.Cookies.Add(cookie);
        }
        else
        {
            sb.Append("Cookie retrieved from client. <br/>");
            sb.Append("Cookie Name: " + cookie.Name + "<br/>");
            sb.Append("Cookie Value: " + cookie.Value + "<br/>");
            sb.Append("Cookie Expiration Date: " + 
                cookie.Expires.ToString() + "<br/>");
        }
        Label1.Text = sb.ToString();
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpCookie Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1" runat="server"></asp:Label>
    </div>
    </form>
</body>
</html>


  • AspNetHostingPermission 

    pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal.

System.Object
  System.Web.HttpCookie

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0
Afficher: