HttpRequest.Cookies HttpRequest.Cookies HttpRequest.Cookies HttpRequest.Cookies Property

定義

Gets a collection of cookies sent by the client.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

屬性值

HttpCookieCollection 物件,代表用戶端的 Cookie 變數。An HttpCookieCollection object representing the client's cookie variables.

範例

下列程式碼範例會對用戶端所傳送的所有 cookie 執行迴圈, 並將每個 cookie 的名稱、到期日、安全性參數和值傳送至 HTTP 輸出。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
  

備註

ASP.NET 包含兩個內建的 cookie 集合。ASP.NET includes two intrinsic cookie collections. 透過的Cookies Cookie集合存取的集合包含由用戶端傳送至標頭中伺服器的cookie。HttpRequestThe collection accessed through the Cookies collection of HttpRequest contains cookies transmitted by the client to the server in the Cookie header. 透過的Cookies Set-Cookie集合存取的集合包含在伺服器上建立的新cookie,並將其傳送至標頭中的用戶端。HttpResponseThe 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.

注意

當您使用HttpResponse.Cookies集合新增 cookie 之後, 即使尚未將回應傳送至用戶端, HttpRequest.Cookies該 cookie 仍會立即在集合中提供。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.

適用於

另請參閱