HttpRequest.Cookies Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém uma coleção de cookies enviados 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 da propriedade
Um objeto HttpCookieCollection que representa as variáveis de cookie do cliente.
Exemplos
O exemplo de código a seguir percorre todos os cookies enviados pelo cliente e envia o nome, a data de expiração, o parâmetro de segurança e os 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
Comentários
ASP.NET inclui duas coleções de cookies intrínsecos. A coleção acessada por meio da Cookies coleção de HttpRequest cookies contém cookies transmitidos pelo cliente para o servidor no Cookie
cabeçalho. A coleção acessada por meio da Cookies coleção de HttpResponse contém novos cookies criados no servidor e transmitidos para o cliente no Set-Cookie
cabeçalho.
Observação
Depois de adicionar um cookie usando a HttpResponse.Cookies coleção, o cookie estará disponível imediatamente na HttpRequest.Cookies coleção, mesmo que a resposta não tenha sido enviada ao cliente.