HttpRequest.Cookies Propriété

Référence

Définition

Espace de noms:: System.Web

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient une collection de cookies envoyée par le client.

public:
 property System::Web::HttpCookieCollection ^ Cookies { System::Web::HttpCookieCollection ^ get(); };

public System.Web.HttpCookieCollection Cookies { get; }

member this.Cookies : System.Web.HttpCookieCollection

Public ReadOnly Property Cookies As HttpCookieCollection

Valeur de propriété

HttpCookieCollection

Objet HttpCookieCollection représentant les variables de cookies du client.

Exemples

L’exemple de code suivant effectue une boucle dans tous les cookies envoyés par le client et envoie le nom, la date d’expiration, le paramètre de sécurité et les valeurs de chaque cookie à la sortie HTTP.

int loop1, loop2;
HttpCookieCollection MyCookieColl;
HttpCookie MyCookie;

MyCookieColl = Request.Cookies;

// Capture all cookie names into a string array.
String[] arr1 = MyCookieColl.AllKeys;

// Grab individual cookie objects by cookie name.
for (loop1 = 0; loop1 < arr1.Length; loop1++)
{
   MyCookie = MyCookieColl[arr1[loop1]];
   Response.Write("Cookie: " + MyCookie.Name + "<br>");
   Response.Write ("Secure:" + MyCookie.Secure + "<br>");

   //Grab all values for single cookie into an object array.
   String[] arr2 = MyCookie.Values.AllKeys;

   //Loop through cookie Value collection and print all values.
   for (loop2 = 0; loop2 < arr2.Length; loop2++)
   {
      Response.Write("Value" + loop2 + ": " + Server.HtmlEncode(arr2[loop2]) + "<br>");
   }
}

Dim loop1, loop2 As Integer
Dim arr1(), arr2() As String
Dim MyCookieColl As HttpCookieCollection 
Dim MyCookie As HttpCookie

MyCookieColl = Request.Cookies
' Capture all cookie names into a string array.
arr1 = MyCookieColl.AllKeys
' Grab individual cookie objects by cookie name     
for loop1 = 0 To arr1.GetUpperBound(0)
   MyCookie = MyCookieColl(arr1(loop1))
   Response.Write("Cookie: " & MyCookie.Name & "<br>")
           Response.Write("Secure:" & MyCookie.Secure & "<br>")

   ' Grab all values for single cookie into an object array.
   arr2 = MyCookie.Values.AllKeys
   ' Loop through cookie value collection and print all values.
   for loop2 = 0 To arr2.GetUpperBound(0)
      Response.Write("Value " & CStr(loop2) + ": " & Server.HtmlEncode(arr2(loop2)) & "<br>")
   Next loop2
Next loop1

Remarques

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

Remarque

Une fois que vous avez ajouté un cookie à l’aide de la HttpResponse.Cookies collection, le cookie est immédiatement disponible dans la HttpRequest.Cookies collection, même si la réponse n’a pas été envoyée au client.

S’applique à

Produit	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8

Partage via