HttpRequest.Cookies Property

Definition

Ruft eine Auflistung der vom Client gesendeten Cookies ab.Gets a collection of cookies sent by the 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

Property Value

HttpCookieCollection

Ein HttpCookieCollection-Objekt, das die Cookievariablen des Clients darstellt.An HttpCookieCollection object representing the client's cookie variables.

Examples

Im folgenden Codebeispiel werden alle vom Client gesendeten Cookies durchlaufen und der Name, das Ablaufdatum, der Sicherheitsparameter und die Werte der einzelnen Cookies an die HTTP-Ausgabe gesendet.The following code example loops through all cookies sent by the client and sends the name, expiration date, security parameter, and values of each cookie to the HTTP output.

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
  

Remarks

ASP.NET enthält zwei systeminterne Cookie-Auflistungen.ASP.NET includes two intrinsic cookie collections. Die Auflistung, auf die über die Cookies-Auflistung von HttpRequest zugegriffen wird, enthält Cookies, die vom Client an den Server im Cookie-Header übertragen werden.The collection accessed through the Cookies collection of HttpRequest contains cookies transmitted by the client to the server in the Cookie header. Die Auflistung, auf die über die Cookies Auflistung von HttpResponse zugegriffen wird, enthält neue Cookies, die auf dem Server erstellt und im Set-Cookie Header an den Client übermittelt werden.The collection accessed through the Cookies collection of HttpResponse contains new cookies created on the server and transmitted to the client in the Set-Cookie header.

Note

Nachdem Sie mithilfe der HttpResponse.Cookies Auflistung ein Cookie hinzugefügt haben, ist das Cookie sofort in der HttpRequest.Cookies Auflistung verfügbar, auch wenn die Antwort nicht an den Client gesendet wurde.After you add a cookie by using the HttpResponse.Cookies collection, the cookie is immediately available in the HttpRequest.Cookies collection, even if the response has not been sent to the client.

Applies to

See also