HttpCookieCollection Klass

Definition

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

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

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
Arv
Object
NameObjectCollectionBase
HttpCookieCollection

Exempel

Följande kodexempel visar hur du läser cookies med Cookies hjälp av objektets HttpRequest egenskap och skriver cookies med hjälp Cookies av objektets HttpResponse egenskap. Båda egenskaperna returnerar HttpCookieCollection objekt. Om någon av två cookies heter userName och lastVisit inte finns med i HTTP-begäran skapas de i HTTP-svaret. Om de två cookies finns visas egenskaperna för cookies.

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

Konstruktorer

Name Description
HttpCookieCollection()

Initierar en ny instans av HttpCookieCollection klassen.

Egenskaper

Name Description
AllKeys

Hämtar en strängmatris som innehåller alla nycklar (cookienamn) i cookiesamlingen.
Count

Hämtar antalet nyckel/värde-par som finns i instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)
IsReadOnly

Hämtar eller anger ett värde som anger om instansen NameObjectCollectionBase är skrivskyddad.

(Ärvd från NameObjectCollectionBase)
Item[Int32]

Hämtar cookien med det angivna numeriska indexet från cookiesamlingen.
Item[String]

Hämtar cookien med det angivna namnet från cookiesamlingen.
Keys

Hämtar en NameObjectCollectionBase.KeysCollection instans som innehåller alla nycklar i instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)

Metoder

Name Description
Add(HttpCookie)

Lägger till den angivna cookien i cookiesamlingen.
BaseAdd(String, Object)

Lägger till en post med den angivna nyckeln och värdet i instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)
BaseClear()

Tar bort alla poster från instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)
BaseGet(Int32)

Hämtar värdet för posten vid det angivna indexet för instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)
BaseGet(String)

Hämtar värdet för den första posten med den angivna nyckeln från instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)
BaseGetAllKeys()

Returnerar en String matris som innehåller alla nycklar i instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)
BaseGetAllValues()

Returnerar en Object matris som innehåller alla värden i instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)
BaseGetAllValues(Type)

Returnerar en matris av den angivna typen som innehåller alla värden i instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)
BaseGetKey(Int32)

Hämtar nyckeln för posten vid det angivna indexet för instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)
BaseHasKeys()

Hämtar ett värde som anger om instansen NameObjectCollectionBase innehåller poster vars nycklar inte nullär .

(Ärvd från NameObjectCollectionBase)
BaseRemove(String)

Tar bort posterna med den angivna nyckeln från instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)
BaseRemoveAt(Int32)

Tar bort posten vid det angivna indexet för instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)
BaseSet(Int32, Object)

Anger värdet för posten vid det angivna indexet för instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)
BaseSet(String, Object)

Anger värdet för den första posten med den angivna nyckeln i instansen, om den NameObjectCollectionBase hittas. Annars lägger du till en post med den angivna nyckeln och värdet i instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)
Clear()

Rensar alla cookies från cookiesamlingen.
CopyTo(Array, Int32)

Kopierar medlemmar i cookiesamlingen till en Array början vid det angivna indexet för matrisen.
Equals(Object)

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

(Ärvd från Object)
Get(Int32)

HttpCookie Returnerar objektet med det angivna indexet från cookiesamlingen.
Get(String)

Returnerar cookien med det angivna namnet från cookiesamlingen.
GetEnumerator()

Returnerar en uppräkning som itererar genom NameObjectCollectionBase.

(Ärvd från NameObjectCollectionBase)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetKey(Int32)

Returnerar cookiens nyckel (namn) vid det angivna numeriska indexet.
GetObjectData(SerializationInfo, StreamingContext)
Föråldrad.

Implementerar ISerializable gränssnittet och returnerar de data som behövs för att serialisera instansen NameObjectCollectionBase .

(Ärvd från NameObjectCollectionBase)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
OnDeserialization(Object)

Implementerar ISerializable gränssnittet och höjer deserialiseringshändelsen när deserialiseringen är klar.

(Ärvd från NameObjectCollectionBase)
Remove(String)

Tar bort cookien med det angivna namnet från samlingen.
Set(HttpCookie)

Uppdaterar värdet för en befintlig cookie i en cookiesamling.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Explicita gränssnittsimplementeringar

Name Description
ICollection.CopyTo(Array, Int32)

Kopierar hela NameObjectCollectionBase till en kompatibel endimensionell Array, med början vid det angivna indexet för målmatrisen.

(Ärvd från NameObjectCollectionBase)
ICollection.IsSynchronized

Hämtar ett värde som anger om åtkomsten NameObjectCollectionBase till objektet synkroniseras (trådsäker).

(Ärvd från NameObjectCollectionBase)
ICollection.SyncRoot

Hämtar ett objekt som kan användas för att synkronisera åtkomsten NameObjectCollectionBase till objektet.

(Ärvd från NameObjectCollectionBase)

Tilläggsmetoder

Name Description
AsParallel(IEnumerable)

Möjliggör parallellisering av en fråga.
AsQueryable(IEnumerable)

Konverterar en IEnumerable till en IQueryable.
Cast<TResult>(IEnumerable)

Omvandlar elementen i en IEnumerable till den angivna typen.
OfType<TResult>(IEnumerable)

Filtrerar elementen i en IEnumerable baserat på en angiven typ.

Gäller för

Se även