HttpCookie Klass

Definition

Namnområde:
System.Web
Sammansättning:
System.Web.dll

Ger ett typsäkert sätt att skapa och manipulera enskilda HTTP-cookies.

public ref class HttpCookie sealed
public sealed class HttpCookie
type HttpCookie = class
Public NotInheritable Class HttpCookie
Arv
Object
HttpCookie

Exempel

Följande kodexempel visar hur du söker efter en cookie med namnet DateCookieExample i HttpRequest objektet. Om cookien inte hittas skapas den och läggs till i HttpResponse objektet. Cookien kommer att upphöra att gälla om 10 minuter.

<%@ 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>

Kommentarer

Klassen HttpCookie hämtar och anger egenskaper för enskilda cookies. Klassen HttpCookieCollection innehåller metoder för att lagra, hämta och hantera flera cookies.

ASP.NET innehåller två inbyggda cookiesamlingar. Samlingen som nås via Cookies samlingen av HttpRequest objektet innehåller cookies som skickas av klienten till servern i Cookie rubriken. Samlingen som nås via Cookies samlingen av HttpResponse objektet innehåller nya cookies som skapats på servern och som överförs till klienten i Set-Cookie HTTP-svarshuvudet.

Konstruktorer

Name Description
HttpCookie(String, String)

Skapar, namnger och tilldelar ett värde till en ny cookie.
HttpCookie(String)

Skapar och namnger en ny cookie.

Egenskaper

Name Description
Domain

Hämtar eller anger domänen som cookien ska associeras med.
Expires

Hämtar eller anger förfallodatum och tid för cookien.
HasKeys

Hämtar ett värde som anger om en cookie har undernycklar.
HttpOnly

Hämtar eller anger ett värde som anger om en cookie är tillgänglig för skript på klientsidan.
Item[String]

Hämtar en genväg till egenskapen Values . Den här egenskapen tillhandahålls för kompatibilitet med tidigare versioner av Active Server Pages (ASP).
Name

Hämtar eller anger namnet på en cookie.
Path

Hämtar eller anger den virtuella sökvägen för överföring med den aktuella cookien.
SameSite

Hämtar eller anger värdet för attributet SameSite för cookien.
Secure

Hämtar eller anger ett värde som anger om cookien ska överföras med hjälp av SSL (Secure Sockets Layer) – dvs. endast via HTTPS.
Shareable

Avgör om cookien tillåts delta i cachelagring av utdata.
Value

Hämtar eller anger ett enskilt cookievärde.
Values

Hämtar en samling nyckel/värde-par som finns i ett enda cookie-objekt.

Metoder

Name Description
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
TryParse(String, HttpCookie)

Konverterar den angivna strängrepresentationen av en cookie till dess HttpCookie motsvarighet och returnerar ett värde som anger om konverteringen lyckades.

Gäller för

Se även