HttpCookie Kelas

Definisi

Ruang nama:
System.Web
Rakitan:
System.Web.dll

Menyediakan cara yang aman untuk membuat dan memanipulasi cookie HTTP individual.

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

Contoh

Contoh kode berikut menunjukkan cara memeriksa cookie bernama DateCookieExample dalam HttpRequest objek . Jika cookie tidak ditemukan, cookie dibuat dan ditambahkan ke HttpResponse objek. Cookie diatur untuk kedaluwarsa dalam 10 menit.

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

Keterangan

Kelas HttpCookie mendapatkan dan menetapkan properti cookie individual. Kelas ini HttpCookieCollection menyediakan metode untuk menyimpan, mengambil, dan mengelola beberapa cookie.

ASP.NET mencakup dua koleksi cookie intrinsik. Koleksi yang diakses melalui Cookies kumpulan HttpRequest objek berisi cookie yang dikirimkan oleh klien ke server di Cookie header. Koleksi yang diakses melalui Cookies kumpulan HttpResponse objek berisi cookie baru yang dibuat di server dan dikirimkan ke klien di Set-Cookie header respons HTTP.

Konstruktor

Nama Deskripsi
HttpCookie(String, String)

Membuat, menamai, dan menetapkan nilai ke cookie baru.
HttpCookie(String)

Membuat dan memberi nama cookie baru.

Properti

Nama Deskripsi
Domain

Mendapatkan atau mengatur domain untuk mengaitkan cookie.
Expires

Mendapatkan atau menetapkan tanggal dan waktu kedaluwarsa untuk cookie.
HasKeys

Mendapatkan nilai yang menunjukkan apakah cookie memiliki subkuncu.
HttpOnly

Mendapatkan atau menetapkan nilai yang menentukan apakah cookie dapat diakses oleh skrip sisi klien.
Item[String]

Mendapatkan pintasan ke Values properti . Properti ini disediakan untuk kompatibilitas dengan versi Halaman Server Aktif (ASP) sebelumnya.
Name

Mendapatkan atau menetapkan nama cookie.
Path

Mendapatkan atau mengatur jalur virtual untuk ditransmisikan dengan cookie saat ini.
SameSite

Mendapatkan atau menetapkan nilai untuk atribut SameSite cookie.
Secure

Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan mengirimkan cookie menggunakan Secure Sockets Layer (SSL)--yaitu, melalui HTTPS saja.
Shareable

Menentukan apakah cookie diizinkan untuk berpartisipasi dalam penembolokan output.
Value

Mendapatkan atau menetapkan nilai cookie individual.
Values

Mendapatkan kumpulan pasangan kunci/nilai yang terkandung dalam satu objek cookie.

Metode

Nama Deskripsi
Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan Type instans saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari Objectsaat ini.

(Diperoleh dari Object)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)
TryParse(String, HttpCookie)

Mengonversi representasi string cookie yang ditentukan menjadi HttpCookie setara dan mengembalikan nilai yang menunjukkan apakah konversi berhasil.

Berlaku untuk

Lihat juga