HttpCookieCollection Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapewnia bezpieczny typ sposób manipulowania plikami 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

Dziedziczenie: Object

NameObjectCollectionBase
HttpCookieCollection

Przykłady

Poniższy przykład kodu pokazuje, jak odczytywać pliki cookie przy użyciu właściwości HttpRequest obiektu i zapisywać pliki cookie przy użyciu Cookies Cookies właściwości HttpResponse obiektu. Obie właściwości zwracają HttpCookieCollection obiekty. Jeśli jeden z dwóch plików cookie o nazwie userName i lastVisit nie znajdują się w żądaniu HTTP, są one tworzone w odpowiedzi HTTP. Jeśli istnieją dwa pliki cookie, zostaną wyświetlone właściwości plików cookie.

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

Konstruktory

HttpCookieCollection()

Inicjuje nowe wystąpienie klasy HttpCookieCollection.

Właściwości

AllKeys	Pobiera tablicę ciągów zawierającą wszystkie klucze (nazwy plików cookie) w kolekcji plików cookie.
Count	Pobiera liczbę par klucz/wartość zawartych w wystąpieniu NameObjectCollectionBase . (Odziedziczone po NameObjectCollectionBase)
IsReadOnly	Pobiera lub ustawia wartość wskazującą, czy NameObjectCollectionBase wystąpienie jest tylko do odczytu. (Odziedziczone po NameObjectCollectionBase)
Item[Int32]	Pobiera plik cookie z określonym indeksem liczbowym z kolekcji plików cookie.
Item[String]	Pobiera plik cookie o określonej nazwie z kolekcji plików cookie.
Keys	NameObjectCollectionBase.KeysCollection Pobiera wystąpienie zawierające wszystkie klucze w wystąpieniuNameObjectCollectionBase. (Odziedziczone po NameObjectCollectionBase)

Metody

Add(HttpCookie)	Dodaje określony plik cookie do kolekcji plików cookie.
BaseAdd(String, Object)	Dodaje wpis z określonym kluczem i wartością NameObjectCollectionBase do wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseClear()	Usuwa wszystkie wpisy z NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseGet(Int32)	Pobiera wartość wpisu w określonym indeksie NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseGet(String)	Pobiera wartość pierwszego wpisu z określonym kluczem z NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseGetAllKeys()	Zwraca tablicę zawierającą String wszystkie klucze w wystąpieniu NameObjectCollectionBase . (Odziedziczone po NameObjectCollectionBase)
BaseGetAllValues()	Zwraca tablicę zawierającą Object wszystkie wartości w wystąpieniu NameObjectCollectionBase . (Odziedziczone po NameObjectCollectionBase)
BaseGetAllValues(Type)	Zwraca tablicę określonego typu, która zawiera wszystkie wartości w wystąpieniu NameObjectCollectionBase . (Odziedziczone po NameObjectCollectionBase)
BaseGetKey(Int32)	Pobiera klucz wpisu w określonym indeksie NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseHasKeys()	Pobiera wartość wskazującą, czy NameObjectCollectionBase wystąpienie zawiera wpisy, których klucze nie `null`są . (Odziedziczone po NameObjectCollectionBase)
BaseRemove(String)	Usuwa wpisy z określonym kluczem z NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseRemoveAt(Int32)	Usuwa wpis w określonym indeksie NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseSet(Int32, Object)	Ustawia wartość wpisu w określonym indeksie NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
BaseSet(String, Object)	Ustawia wartość pierwszego wpisu z określonym kluczem w wystąpieniu NameObjectCollectionBase , jeśli zostanie znaleziony. W przeciwnym razie dodaje wpis z określonym kluczem i wartością NameObjectCollectionBase do wystąpienia. (Odziedziczone po NameObjectCollectionBase)
Clear()	Czyści wszystkie pliki cookie z kolekcji plików cookie.
CopyTo(Array, Int32)	Kopiuje elementy członkowskie kolekcji plików cookie na Array początek w określonym indeksie tablicy.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Get(Int32)	HttpCookie Zwraca element z określonym indeksem z kolekcji plików cookie.
Get(String)	Zwraca plik cookie o określonej nazwie z kolekcji plików cookie.
GetEnumerator()	Zwraca moduł wyliczający, który iteruje za pomocą elementu NameObjectCollectionBase. (Odziedziczone po NameObjectCollectionBase)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetKey(Int32)	Zwraca klucz (nazwę) pliku cookie w określonym indeksie liczbowym.
GetObjectData(SerializationInfo, StreamingContext)	Przestarzałe. Implementuje ISerializable interfejs i zwraca dane potrzebne do serializacji NameObjectCollectionBase wystąpienia. (Odziedziczone po NameObjectCollectionBase)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnDeserialization(Object)	Implementuje ISerializable interfejs i zgłasza zdarzenie deserializacji po zakończeniu deserializacji. (Odziedziczone po NameObjectCollectionBase)
Remove(String)	Usuwa plik cookie z określoną nazwą z kolekcji.
Set(HttpCookie)	Aktualizacje wartość istniejącego pliku cookie w kolekcji plików cookie.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

ICollection.CopyTo(Array, Int32)	Kopiuje całą NameObjectCollectionBase do zgodnej jednowymiarowej Arraytablicy, zaczynając od określonego indeksu tablicy docelowej. (Odziedziczone po NameObjectCollectionBase)
ICollection.IsSynchronized	Pobiera wartość wskazującą, czy dostęp do NameObjectCollectionBase obiektu jest synchronizowany (bezpieczny wątek). (Odziedziczone po NameObjectCollectionBase)
ICollection.SyncRoot	Pobiera obiekt, który może służyć do synchronizowania dostępu do NameObjectCollectionBase obiektu. (Odziedziczone po NameObjectCollectionBase)

Metody rozszerzania

Cast<TResult>(IEnumerable)	Rzutuje elementy elementu IEnumerable na określony typ.
OfType<TResult>(IEnumerable)	Filtruje elementy elementu IEnumerable na podstawie określonego typu.
AsParallel(IEnumerable)	Umożliwia równoległość zapytania.
AsQueryable(IEnumerable)	Konwertuje element IEnumerable na .IQueryable

Dotyczy

Zobacz też

HttpCookie