Udostępnij za pośrednictwem


HttpCookieCollection Klasa

Definicja

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
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 CookiesCookies 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 nullsą .

(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ż