مجموعه کوکی‌های ASP

دستورالعمل‌های مرجع اشیاء Request

مجموعه کوکی‌ها برای تنظیم یا دریافت مقدار کوکی استفاده می‌شود. اگر کوکی وجود نداشته باشد، ایجاد می‌شود و مقدار مشخص شده به آن اختصاص داده می‌شود.

نکته:فرمان Response.Cookies باید قبل از برچسب <html> قرار گیرد.

نحوه استفاده:

Response.Cookies(name)[(key)|.attribute]=value
variablename=Request.Cookies(name)[(key)|.attribute]
پارامتر توضیح
name ضروری. نام کوکی.
value ضروری (برای فرمان Response.Cookies). مقدار کوکی.
attribute

اختیاری. اطلاعات مربوط به کوکی را تعیین می‌کند. می‌تواند یکی از پارامترهای زیر باشد.

  • Domain - فقط نوشتاری; کوکی فقط به درخواست‌هایی که به این دامنه می‌رسند ارسال می‌شود.
  • Expires - فقط نوشتاری; تاریخ انقضای کوکی. اگر تاریخ مشخص نشده باشد، کوکی در پایان جلسه انقضا می‌کند.
  • HasKeys - فقط خواندنی; نشان‌دهنده این که کوکی کلیدهای دارد یا خیر (این تنها ویژگی است که می‌توان با فرمان Request.Cookies استفاده کرد).
  • Path - فقط نوشتاری; اگر تنظیم شود، کوکی فقط به درخواست‌هایی که به این مسیر می‌رسند ارسال می‌شود. اگر تنظیم نشده باشد، از مسیر برنامه استفاده می‌شود.
  • Secure - فقط نوشتاری; نشان‌دهنده این که کوکی آیا امن است یا خیر.
کلید اختیاری. کلیدهای تعیین شده برای مکان اختصاص داده شده.

مثال

فرمان "Response.Cookies" برای ایجاد کوکی یا تنظیم مقدار کوکی استفاده می‌شود:

<%
Response.Cookies("firstname")="Alex"
%>

در کد بالا، ما یک کوکی به نام "firstname" ایجاد کرده و به آن مقدار alex را اختصاص دادیم.

همچنین می‌توان برای کوکی‌ها ویژگی‌هایی مانند تنظیم زمان انقضای کوکی را تنظیم کرد:

<%
Response.Cookies("firstname")="Alex"　
Response.Cookies("firstname").Expires=#May 10,2002#
%>

در حال حاضر، مقدار کوکی به نام "firstname" "Alex" است و تاریخ انقضای آن در کامپیوتر کاربر در 10 مه 2002 است.

"Request.Cookies" دستور برای بازیابی مقدار کوکی استفاده می‌شود.

در مثال زیر، ما مقدار کوکی "firstname" را بازیابی کرده‌ایم و آن را روی صفحه نمایش داده‌ایم:

<%
fname=Request.Cookies("firstname")
response.write("Firstname=" & fname)
%>

خروجی:

Firstname=Alex

یک کوکی می‌تواند یک مجموعه چند ارزشی را شامل شود. این را می‌گوییم که کوکی دارای کلید است.

در مثال زیر، ما می‌خواهیم یک مجموعه کوکی به نام "user" ایجاد کنیم. کوکی "user" دارای کلیدهایی است که شامل اطلاعات کاربر هستند.

<%
Response.Cookies("user")("firstname")="John"
Response.Cookies("user")("lastname")="Adams"
Response.Cookies("user")("country")="UK"
Response.Cookies("user")("age")="25"
%>

این کد می‌تواند تمام کوکی‌هایی که سرور به کاربر ارسال کرده است را خواند. توجه داشته باشید که ما از ویژگی HasKeys برای تعیین اینکه آیا کوکی دارای کلید است یا خیر استفاده کرده‌ایم:

<html>
<body>
<%
dim x,y
for each x in Request.Cookies
  response.write("<p>")
  if Request.Cookies(x).HasKeys then
    for each y in Request.Cookies(x)
      response.write(x & ":" & y & "=" & Request.Cookies(x)(y))
      response.write("<br /")
    next
  else
    Response.Write(x & "=" & Request.Cookies(x) & "<br />")
  end if
  response.write "</p>"
next
%>
</body>
</html>
%>

خروجی:

firstname=Alex
user:firstname=John
user:lastname=Adams
user:
country=UK
user:
age=25

دستورالعمل‌های مرجع اشیاء Request