HttpCookieCollection Osztály

Definíció

Névtér:: System.Web

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Típusbiztos módot biztosít a HTTP-cookie-k kezelésére.

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

Öröklődés: Object

NameObjectCollectionBase
HttpCookieCollection

Példák

Az alábbi példakód bemutatja, hogyan olvashatja el a cookie-kat az Cookies HttpRequest objektum tulajdonságával, és hogyan írhat cookie-kat az Cookies HttpResponse objektum tulajdonságával. Mindkét tulajdonság objektumokat ad vissza HttpCookieCollection . Ha két cookie neve userNamelastVisit vagy nem szerepel a HTTP-kérelemben, akkor azok a HTTP-válaszban jönnek létre. Ha a két cookie létezik, a cookie-k tulajdonságai megjelennek.

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

Konstruktorok

Name	Description
HttpCookieCollection()	Inicializálja a HttpCookieCollection osztály új példányát.

Tulajdonságok

Name	Description
AllKeys	Lekéri a cookie-gyűjtemény összes kulcsát (cookie-nevét) tartalmazó sztringtömböt.
Count	Lekéri a példányban NameObjectCollectionBase található kulcs-/értékpárok számát. (Öröklődés forrása NameObjectCollectionBase)
IsReadOnly	Lekéri vagy beállít egy értéket, amely jelzi, hogy a NameObjectCollectionBase példány írásvédett-e. (Öröklődés forrása NameObjectCollectionBase)
Item[Int32]	Lekéri a cookie-t a megadott numerikus indexkel a cookie-gyűjteményből.
Item[String]	Lekéri a cookie-t a megadott névvel a cookie-gyűjteményből.
Keys	NameObjectCollectionBase.KeysCollection Lekéri a példány összes kulcsát tartalmazó példánytNameObjectCollectionBase. (Öröklődés forrása NameObjectCollectionBase)

Metódusok

Name	Description
Add(HttpCookie)	Hozzáadja a megadott cookie-t a cookie-gyűjteményhez.
BaseAdd(String, Object)	Hozzáad egy bejegyzést a megadott kulccsal és értékkel a NameObjectCollectionBase példányhoz. (Öröklődés forrása NameObjectCollectionBase)
BaseClear()	Eltávolítja az összes bejegyzést a NameObjectCollectionBase példányból. (Öröklődés forrása NameObjectCollectionBase)
BaseGet(Int32)	Lekéri a bejegyzés értékét a példány megadott indexében NameObjectCollectionBase . (Öröklődés forrása NameObjectCollectionBase)
BaseGet(String)	Lekéri az első bejegyzés értékét a megadott kulccsal a NameObjectCollectionBase példányból. (Öröklődés forrása NameObjectCollectionBase)
BaseGetAllKeys()	Egy tömböt ad String vissza, amely tartalmazza a példány összes kulcsát NameObjectCollectionBase . (Öröklődés forrása NameObjectCollectionBase)
BaseGetAllValues()	Egy tömböt ad Object vissza, amely a példány összes értékét NameObjectCollectionBase tartalmazza. (Öröklődés forrása NameObjectCollectionBase)
BaseGetAllValues(Type)	A megadott típusú tömböt adja vissza, amely a példány összes értékét NameObjectCollectionBase tartalmazza. (Öröklődés forrása NameObjectCollectionBase)
BaseGetKey(Int32)	Lekéri a bejegyzés kulcsát a példány megadott indexében NameObjectCollectionBase . (Öröklődés forrása NameObjectCollectionBase)
BaseHasKeys()	Egy értéket kap, amely jelzi, hogy a NameObjectCollectionBase példány tartalmaz-e olyan bejegyzéseket, amelyek kulcsai nem `null`. (Öröklődés forrása NameObjectCollectionBase)
BaseRemove(String)	Eltávolítja a megadott kulccsal rendelkező bejegyzéseket a NameObjectCollectionBase példányból. (Öröklődés forrása NameObjectCollectionBase)
BaseRemoveAt(Int32)	Eltávolítja a bejegyzést a példány megadott indexéből NameObjectCollectionBase . (Öröklődés forrása NameObjectCollectionBase)
BaseSet(Int32, Object)	A bejegyzés értékét a példány megadott indexében állítja NameObjectCollectionBase be. (Öröklődés forrása NameObjectCollectionBase)
BaseSet(String, Object)	Beállítja az első bejegyzés értékét a példányban NameObjectCollectionBase megadott kulccsal, ha megtalálható; ellenkező esetben hozzáad egy bejegyzést a megadott kulccsal és értékkel a NameObjectCollectionBase példányhoz. (Öröklődés forrása NameObjectCollectionBase)
Clear()	Törli az összes cookie-t a cookie-gyűjteményből.
CopyTo(Array, Int32)	A cookie-gyűjtemény tagjait a tömb megadott indexének egyik Array elejére másolja.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
Get(Int32)	HttpCookie A megadott indexet tartalmazó elemet adja vissza a cookie-gyűjteményből.
Get(String)	Visszaadja a cookie-t a megadott névvel a cookie-gyűjteményből.
GetEnumerator()	Egy enumerátort ad vissza, amely a NameObjectCollectionBase. (Öröklődés forrása NameObjectCollectionBase)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetKey(Int32)	A cookie kulcsát (nevét) adja vissza a megadott numerikus indexben.
GetObjectData(SerializationInfo, StreamingContext)	Elavult. Implementálja az interfészt ISerializable , és visszaadja a példány szerializálásához NameObjectCollectionBase szükséges adatokat. (Öröklődés forrása NameObjectCollectionBase)
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)
OnDeserialization(Object)	Implementálja az ISerializable interfészt, és a deszerializálás befejezésekor aktiválja a deszerializálási eseményt. (Öröklődés forrása NameObjectCollectionBase)
Remove(String)	Eltávolítja a megadott nevű cookie-t a gyűjteményből.
Set(HttpCookie)	Frissíti egy meglévő cookie értékét egy cookie-gyűjteményben.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Explicit interfész-implementációk

Name	Description
ICollection.CopyTo(Array, Int32)	A teljes NameObjectCollectionBase példányt egy kompatibilis egydimenziósra Arraymásolja a céltömb megadott indexétől kezdve. (Öröklődés forrása NameObjectCollectionBase)
ICollection.IsSynchronized	Lekérdez egy értéket, amely jelzi, hogy az NameObjectCollectionBase objektumhoz való hozzáférés szinkronizálva van-e (szálbiztos). (Öröklődés forrása NameObjectCollectionBase)
ICollection.SyncRoot	Lekéri az objektumhoz való hozzáférés NameObjectCollectionBase szinkronizálására használható objektumot. (Öröklődés forrása NameObjectCollectionBase)

Bővítő metódusok

Name	Description
AsParallel(IEnumerable)	Lehetővé teszi a lekérdezés párhuzamosítását.
AsQueryable(IEnumerable)	Átalakítja az egyiket IEnumerable IQueryable.
Cast<TResult>(IEnumerable)	Egy elem elemeit IEnumerable a megadott típusra veti.
OfType<TResult>(IEnumerable)	Egy adott típus alapján szűri IEnumerable egy adott elem elemeit.

A következőre érvényes:

Lásd még

HttpCookie

Visszajelzés

Hasznosnak találta ezt az oldalt?