HttpCookieCollection Kelas

Referensi

Definisi

Ruang nama:: System.Web

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyediakan cara yang aman untuk memanipulasi cookie HTTP.

public ref class HttpCookieCollection sealed : System::Collections::Specialized::NameObjectCollectionBase

public sealed class HttpCookieCollection : System.Collections.Specialized.NameObjectCollectionBase

type HttpCookieCollection = class
    inherit NameObjectCollectionBase

Public NotInheritable Class HttpCookieCollection
Inherits NameObjectCollectionBase

Warisan: Object

NameObjectCollectionBase
HttpCookieCollection

Contoh

Contoh kode berikut menunjukkan cara membaca cookie menggunakan Cookies properti HttpRequest objek dan menulis cookie menggunakan Cookies properti HttpResponse objek . Kedua properti mengembalikan HttpCookieCollection objek. Jika salah satu dari dua cookie bernama userName dan lastVisit tidak berada dalam permintaan HTTP, maka cookie dibuat dalam respons HTTP. Jika dua cookie ada, properti cookie ditampilkan.

<%@ 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();
        // Check to see if cookies exist in HTTP request.
        if (Request.Cookies["userName"] == null && 
            Request.Cookies["lastVist"] == null)
        {
            Response.Cookies["userName"].Value = "user name";
            Response.Cookies["userName"].Expires = DateTime.Now.AddMinutes(20d);

            HttpCookie aCookie = new HttpCookie("lastVisit");
            aCookie.Value = DateTime.Now.ToString();
            aCookie.Expires = DateTime.Now.AddMinutes(20d);
            Response.Cookies.Add(aCookie);
            sb.Append("Two cookies added to response. " + 
                "Refresh the page to read the cookies.");
        }
        else
        {
            HttpCookieCollection cookies = Request.Cookies;
            for (int i = 0; i < cookies.Count; i++)
            {
                sb.Append("Name: " + cookies[i].Name + "<br/>");
                sb.Append("Value: " + cookies[i].Value + "<br/>");
                sb.Append("Expires: " + cookies[i].Expires.ToString() +
                          "<br/><br/>");
            }
        }
        Label1.Text = sb.ToString();
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpCookieCollection 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()
        ' Check to see if cookies exist in HTTP request.
        If (Request.Cookies("userName") Is Nothing AndAlso _
            Request.Cookies("lastVisit") Is Nothing) Then
            Response.Cookies("userName").Value = "user name"
            Response.Cookies("userName").Expires = DateTime.Now.AddMinutes(20D)

            Dim aCookie As HttpCookie
            aCookie = New HttpCookie("lastVisit")
            aCookie.Value = DateTime.Now.ToString()
            aCookie.Expires = DateTime.Now.AddMinutes(20D)
            Response.Cookies.Add(aCookie)
            sb.Append("Two cookies added to response. " & _
                "Refresh the page to read the cookies.")
        Else
            Dim cookies As HttpCookieCollection
            cookies = Request.Cookies
            For i As Integer = 0 To cookies.Count - 1
                sb.Append("Name: " & cookies(i).Name & "<br/>")
                sb.Append("Value: " & cookies(i).Value & "<br/>")
                sb.Append("Expires: " & cookies(i).Expires.ToString() & _
                          "<br/><br/>")
            Next

        End If
        Label1.Text = sb.ToString()
    End Sub
</script>

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

Konstruktor

HttpCookieCollection()

Menginisialisasi instans baru kelas HttpCookieCollection.

Properti

AllKeys	Mendapatkan array string yang berisi semua kunci (nama cookie) dalam koleksi cookie.
Count	Mendapatkan jumlah pasangan kunci/nilai yang terkandung dalam NameObjectCollectionBase instans. (Diperoleh dari NameObjectCollectionBase)
IsReadOnly	Mendapatkan atau menetapkan nilai yang menunjukkan apakah NameObjectCollectionBase instans bersifat baca-saja. (Diperoleh dari NameObjectCollectionBase)
Item[Int32]	Mendapatkan cookie dengan indeks numerik yang ditentukan dari koleksi cookie.
Item[String]	Mendapatkan cookie dengan nama yang ditentukan dari koleksi cookie.
Keys	Mendapatkan instans NameObjectCollectionBase.KeysCollection yang berisi semua kunci dalam NameObjectCollectionBase instans. (Diperoleh dari NameObjectCollectionBase)

Metode

Add(HttpCookie)	Menambahkan cookie yang ditentukan ke koleksi cookie.
BaseAdd(String, Object)	Menambahkan entri dengan kunci dan nilai yang ditentukan ke NameObjectCollectionBase dalam instans. (Diperoleh dari NameObjectCollectionBase)
BaseClear()	Menghapus semua entri dari NameObjectCollectionBase instans. (Diperoleh dari NameObjectCollectionBase)
BaseGet(Int32)	Mendapatkan nilai entri pada indeks NameObjectCollectionBase instans yang ditentukan. (Diperoleh dari NameObjectCollectionBase)
BaseGet(String)	Mendapatkan nilai entri pertama dengan kunci yang ditentukan dari NameObjectCollectionBase instans. (Diperoleh dari NameObjectCollectionBase)
BaseGetAllKeys()	Mengembalikan String array yang berisi semua kunci dalam NameObjectCollectionBase instans. (Diperoleh dari NameObjectCollectionBase)
BaseGetAllValues()	Mengembalikan Object array yang berisi semua nilai dalam NameObjectCollectionBase instans. (Diperoleh dari NameObjectCollectionBase)
BaseGetAllValues(Type)	Mengembalikan array dari jenis yang ditentukan yang berisi semua nilai dalam NameObjectCollectionBase instans. (Diperoleh dari NameObjectCollectionBase)
BaseGetKey(Int32)	Mendapatkan kunci entri pada indeks NameObjectCollectionBase instans yang ditentukan. (Diperoleh dari NameObjectCollectionBase)
BaseHasKeys()	Mendapatkan nilai yang menunjukkan apakah NameObjectCollectionBase instans berisi entri yang kuncinya bukan `null`. (Diperoleh dari NameObjectCollectionBase)
BaseRemove(String)	Menghapus entri dengan kunci yang ditentukan dari NameObjectCollectionBase instans. (Diperoleh dari NameObjectCollectionBase)
BaseRemoveAt(Int32)	Menghapus entri pada indeks NameObjectCollectionBase instans yang ditentukan. (Diperoleh dari NameObjectCollectionBase)
BaseSet(Int32, Object)	Mengatur nilai entri pada indeks NameObjectCollectionBase instans yang ditentukan. (Diperoleh dari NameObjectCollectionBase)
BaseSet(String, Object)	Mengatur nilai entri pertama dengan kunci yang ditentukan dalam NameObjectCollectionBase instans, jika ditemukan; jika tidak, menambahkan entri dengan kunci dan nilai yang ditentukan ke NameObjectCollectionBase dalam instans. (Diperoleh dari NameObjectCollectionBase)
Clear()	Menghapus semua cookie dari koleksi cookie.
CopyTo(Array, Int32)	Menyalin anggota koleksi cookie ke Array awal pada indeks array yang ditentukan.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Get(Int32)	Mengembalikan HttpCookie item dengan indeks yang ditentukan dari koleksi cookie.
Get(String)	Mengembalikan cookie dengan nama yang ditentukan dari koleksi cookie.
GetEnumerator()	Mengembalikan enumerator yang berulang melalui NameObjectCollectionBase. (Diperoleh dari NameObjectCollectionBase)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetKey(Int32)	Mengembalikan kunci (nama) cookie pada indeks numerik yang ditentukan.
GetObjectData(SerializationInfo, StreamingContext)	Kedaluwarsa. ISerializable Mengimplementasikan antarmuka dan mengembalikan data yang diperlukan untuk membuat serialisasi NameObjectCollectionBase instans. (Diperoleh dari NameObjectCollectionBase)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
OnDeserialization(Object)	ISerializable Mengimplementasikan antarmuka dan meningkatkan peristiwa deserialisasi saat deserialisasi selesai. (Diperoleh dari NameObjectCollectionBase)
Remove(String)	Menghapus cookie dengan nama yang ditentukan dari koleksi.
Set(HttpCookie)	Updates nilai cookie yang ada dalam koleksi cookie.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

ICollection.CopyTo(Array, Int32)	Menyalin seluruh NameObjectCollectionBase ke satu dimensi Arrayyang kompatibel, dimulai dari indeks array target yang ditentukan. (Diperoleh dari NameObjectCollectionBase)
ICollection.IsSynchronized	Mendapatkan nilai yang menunjukkan apakah akses ke objek disinkronkan NameObjectCollectionBase (utas aman). (Diperoleh dari NameObjectCollectionBase)
ICollection.SyncRoot	Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke NameObjectCollectionBase objek. (Diperoleh dari NameObjectCollectionBase)

Metode Ekstensi

Cast<TResult>(IEnumerable)	Mentransmisikan elemen dari ke IEnumerable jenis yang ditentukan.
OfType<TResult>(IEnumerable)	Memfilter elemen berdasarkan IEnumerable jenis yang ditentukan.
AsParallel(IEnumerable)	Mengaktifkan paralelisasi kueri.
AsQueryable(IEnumerable)	Mengonversi menjadi IEnumerable IQueryable.

Berlaku untuk

Lihat juga

HttpCookie

Bagikan melalui