Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

HttpCookie classe

 

Date de publication : novembre 2016

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

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

System.Object
  System.Web.HttpCookie

public sealed class HttpCookie

NomDescription
System_CAPS_pubmethodHttpCookie(String)

Crée et nomme un nouveau cookie.

System_CAPS_pubmethodHttpCookie(String, String)

Crée, des noms et assigne une valeur à un nouveau cookie.

NomDescription
System_CAPS_pubpropertyDomain

Obtient ou définit le domaine auquel associer le cookie.

System_CAPS_pubpropertyExpires

Obtient ou définit la date d’expiration et l’heure pour le cookie.

System_CAPS_pubpropertyHasKeys

Obtient une valeur indiquant si un cookie possède des sous-clés.

System_CAPS_pubpropertyHttpOnly

Obtient ou définit une valeur qui spécifie si un cookie est accessible par un script côté client.

System_CAPS_pubpropertyItem[String]

Obtient un raccourci vers le HttpCookie.Values propriété. Cette propriété est fournie pour la compatibilité avec les versions précédentes de Active Server Pages (ASP).

System_CAPS_pubpropertyName

Obtient ou définit le nom d’un cookie.

System_CAPS_pubpropertyPath

Obtient ou définit le chemin d’accès virtuel à transmettre avec le cookie en cours.

System_CAPS_pubpropertySecure

Obtient ou définit une valeur indiquant s’il faut transmettre le cookie à l’aide de la couche SSL (Secure Sockets), autrement dit, via HTTPS uniquement.

System_CAPS_pubpropertyShareable

Détermine si le cookie est autorisé à participer à la mise en cache de sortie.

System_CAPS_pubpropertyValue

Obtient ou définit une valeur de cookie individuelle.

System_CAPS_pubpropertyValues

Obtient une collection de paires clé/valeur qui sont contenues dans un objet de cookie unique.

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

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

ASP.NET inclut deux collections de cookies intrinsèque. La collection accédée via la Cookies collection de le HttpRequest objet contient des cookies transmis par le client au serveur dans le Cookie en-tête. La collection accédée via la Cookies collection de le HttpResponse objet contient de nouveaux cookies créés sur le serveur et transmis au client dans le Set-Cookie en-tête de réponse HTTP.

L’exemple de code suivant montre comment rechercher un cookie nommé DateCookieExample dans le HttpRequest objet. Si le cookie est introuvable, il est créé et ajouté à la HttpResponse objet. 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>

.NET Framework
Disponible depuis 1.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: