HttpCookie Osztály

Definíció

Névtér:
System.Web
Szerelvény:
System.Web.dll

Típusbiztos módot biztosít az egyes HTTP-cookie-k létrehozására és kezelésére.

public ref class HttpCookie sealed
public sealed class HttpCookie
type HttpCookie = class
Public NotInheritable Class HttpCookie
Öröklődés
Object
HttpCookie

Példák

Az alábbi példakód bemutatja, hogyan ellenőrizheti az objektumban DateCookieExample elnevezett HttpRequest cookie-kat. Ha a cookie nem található, a rendszer létrehozza és hozzáadja az HttpResponse objektumhoz. A cookie 10 percen belül lejár.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Page_Load(object sender, EventArgs e)
    {
        StringBuilder sb = new StringBuilder();
        // Get cookie from the current request.
        HttpCookie cookie = Request.Cookies.Get("DateCookieExample");
        
        // Check if cookie exists in the current request.
        if (cookie == null)
        {
            sb.Append("Cookie was not received from the client. ");
            sb.Append("Creating cookie to add to the response. <br/>");
            // Create cookie.
            cookie = new HttpCookie("DateCookieExample");
            // Set value of cookie to current date time.
            cookie.Value = DateTime.Now.ToString();
            // Set cookie to expire in 10 minutes.
            cookie.Expires = DateTime.Now.AddMinutes(10d);
            // Insert the cookie in the current HttpResponse.
            Response.Cookies.Add(cookie);
        }
        else
        {
            sb.Append("Cookie retrieved from client. <br/>");
            sb.Append("Cookie Name: " + cookie.Name + "<br/>");
            sb.Append("Cookie Value: " + cookie.Value + "<br/>");
            sb.Append("Cookie Expiration Date: " + 
                cookie.Expires.ToString() + "<br/>");
        }
        Label1.Text = sb.ToString();
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpCookie Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1" runat="server"></asp:Label>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
        Dim sb As New StringBuilder()
        ' Get cookie from current request.
        Dim cookie As HttpCookie
        cookie = Request.Cookies.Get("DateCookieExample")
        
        ' Check if cookie exists in the current request
        If (cookie Is Nothing) Then
            sb.Append("Cookie was not received from the client. ")
            sb.Append("Creating cookie to add to the response. <br/>")
            ' Create cookie.
            cookie = New HttpCookie("DateCookieExample")
            ' Set value of cookie to current date time.
            cookie.Value = DateTime.Now.ToString()
            ' Set cookie to expire in 10 minutes.
            cookie.Expires = DateTime.Now.AddMinutes(10D)
            ' Insert the cookie in the current HttpResponse.
            Response.Cookies.Add(cookie)
        Else
            sb.Append("Cookie retrieved from client. <br/>")
            sb.Append("Cookie Name: " + cookie.Name + "<br/>")
            sb.Append("Cookie Value: " + cookie.Value + "<br/>")
            sb.Append("Cookie Expiration Date: " & _
                cookie.Expires.ToString() & "<br/>")
        End If
        Label1.Text = sb.ToString()

    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpCookie Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1" runat="server"></asp:Label>    
    </div>
    </form>
</body>
</html>

Megjegyzések

Az HttpCookie osztály lekéri és beállítja az egyes cookie-k tulajdonságait. Az HttpCookieCollection osztály metódusokat biztosít több cookie tárolására, lekérésére és kezelésére.

ASP.NET két belső cookie-gyűjteményt tartalmaz. Az objektum gyűjteményén Cookies keresztül HttpRequest elért gyűjtemény az ügyfél által a fejlécben lévő Cookie kiszolgálónak továbbított cookie-kat tartalmazza. Az objektum gyűjteményén Cookies keresztül HttpResponse elért gyűjtemény a kiszolgálón létrehozott és az ügyfélnek a HTTP-válasz fejlécében Set-Cookie továbbított új cookie-kat tartalmaz.

Konstruktorok

Name Description
HttpCookie(String, String)

Értéket hoz létre, nevez el és rendel hozzá egy új cookie-hoz.
HttpCookie(String)

Új cookie-t hoz létre és nevez el.

Tulajdonságok

Name Description
Domain

Lekéri vagy beállítja a tartományt a cookie társításához.
Expires

Lekéri vagy beállítja a cookie lejárati dátumát és időpontját.
HasKeys

Lekérdez egy értéket, amely jelzi, hogy a cookie-k alkulcsokkal rendelkeznek-e.
HttpOnly

Lekéri vagy beállít egy értéket, amely meghatározza, hogy egy cookie elérhető-e ügyféloldali szkripttel.
Item[String]

Parancsikont kap a Values tulajdonsághoz. Ez a tulajdonság az Active Server Pages (ASP) korábbi verzióival való kompatibilitást szolgálja.
Name

Lekéri vagy beállítja a cookie nevét.
Path

Lekéri vagy beállítja az aktuális cookie-val továbbítandó virtuális útvonalat.
SameSite

Lekéri vagy beállítja a cookie SameSite attribútumának értékét.
Secure

Lekéri vagy beállít egy értéket, amely jelzi, hogy a cookie-t secure Sockets Layer (SSL) használatával szeretné-e továbbítani – azaz csak HTTPS-en keresztül.
Shareable

Meghatározza, hogy a cookie részt vehet-e a kimeneti gyorsítótárazásban.
Value

Lekéri vagy beállítja az egyes cookie-értékeket.
Values

Egyetlen cookie-objektumban található kulcs-/érték párok gyűjteményét kapja meg.

Metódusok

Name Description
Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)
TryParse(String, HttpCookie)

Átalakítja a cookie megadott sztring-ábrázolását annak HttpCookie megfelelőjeként, és visszaad egy értéket, amely jelzi, hogy az átalakítás sikeres volt-e.

A következőre érvényes:

Lásd még