HttpRequest.Cookies Propriedade

Definição

Recebe uma coleção de cookies enviada pelo cliente.

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

Valor de Propriedade

Um objeto que HttpCookieCollection representa as variáveis de cookies do cliente.

Exemplos

O exemplo de código seguinte percorre todos os cookies enviados pelo cliente e envia o nome, data de expiração, parâmetro de segurança e valores de cada cookie para a saída 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
  

Observações

O ASP.NET inclui duas coleções intrínsecas de cookies. A coleção acedida através da Cookies coleção de HttpRequest contém cookies transmitidos pelo cliente ao servidor no Cookie cabeçalho. A coleção acedida através da Cookies coleção de HttpResponse contém novos cookies criados no servidor e transmitidos ao cliente no Set-Cookie cabeçalho.

Note

Depois de adicionar um cookie usando a HttpResponse.Cookies coleção, o cookie fica imediatamente disponível na HttpRequest.Cookies coleção, mesmo que a resposta não tenha sido enviada ao cliente.

Aplica-se a

Ver também