HttpCookieCollection Klasse

  • Referenz

Definition

Namespace:
System.Web
Assembly:
System.Web.dll

Bietet eine typsichere Möglichkeit zum Verarbeiten von 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
Vererbung
Object
NameObjectCollectionBase
HttpCookieCollection

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Cookies mithilfe der Cookies -Eigenschaft des HttpRequest -Objekts gelesen und Cookies mithilfe der Cookies -Eigenschaft des HttpResponse -Objekts geschrieben werden. Beide Eigenschaften geben Objekte zurück HttpCookieCollection . Wenn einer der beiden Cookies mit dem Namen userName und lastVisit nicht in der HTTP-Anforderung enthalten ist, werden sie in der HTTP-Antwort erstellt. Wenn die beiden Cookies vorhanden sind, werden die Eigenschaften der Cookies angezeigt.

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

Konstruktoren

HttpCookieCollection()

Initialisiert eine neue Instanz der HttpCookieCollection-Klasse.

Eigenschaften

AllKeys

Ruft ein Zeichenfolgenarray ab, das alle Schlüssel (Cookienamen) in der Cookieauflistung enthält.
Count

Ruft die Anzahl von Schlüssel-Wert-Paaren in der NameObjectCollectionBase-Instanz ab.

(Geerbt von NameObjectCollectionBase)
IsReadOnly

Ruft einen Wert ab, der angibt, ob die NameObjectCollectionBase-Instanz schreibgeschützt ist, oder legt diesen fest.

(Geerbt von NameObjectCollectionBase)
Item[Int32]

Ruft das Cookie mit dem angegebenen numerischen Index aus der Cookieauflistung ab.
Item[String]

Ruft das Cookie mit dem angegebenen Namen aus der Cookieauflistung ab.
Keys

Ruft eine NameObjectCollectionBase.KeysCollection-Instanz ab, die alle Schlüssel in der NameObjectCollectionBase-Instanz enthält.

(Geerbt von NameObjectCollectionBase)

Methoden

Add(HttpCookie)

Fügt der Cookieauflistung das angegebene Cookie hinzu.
BaseAdd(String, Object)

Fügt einen Eintrag mit dem angegebenen Schlüssel und Wert der NameObjectCollectionBase-Instanz hinzu.

(Geerbt von NameObjectCollectionBase)
BaseClear()

Entfernt alle Einträge aus der NameObjectCollectionBase-Instanz.

(Geerbt von NameObjectCollectionBase)
BaseGet(Int32)

Ruft den Wert des Eintrags am angegebenen Index der NameObjectCollectionBase-Instanz ab.

(Geerbt von NameObjectCollectionBase)
BaseGet(String)

Ruft den Wert des ersten Eintrags mit dem angegebenen Schlüssel aus der NameObjectCollectionBase-Instanz ab.

(Geerbt von NameObjectCollectionBase)
BaseGetAllKeys()

Gibt ein String-Array zurück, das alle Schlüssel der NameObjectCollectionBase-Instanz enthält.

(Geerbt von NameObjectCollectionBase)
BaseGetAllValues()

Gibt ein Object-Array zurück, das alle Werte der NameObjectCollectionBase-Instanz enthält.

(Geerbt von NameObjectCollectionBase)
BaseGetAllValues(Type)

Gibt ein Array des angegebenen Typs zurück, das alle Werte der NameObjectCollectionBase-Instanz enthält.

(Geerbt von NameObjectCollectionBase)
BaseGetKey(Int32)

Ruft den Schlüssel des Eintrags am angegebenen Index der NameObjectCollectionBase-Instanz ab.

(Geerbt von NameObjectCollectionBase)
BaseHasKeys()

Ruft einen Wert ab, der angibt, ob die NameObjectCollectionBase-Instanz Einträge enthält, deren Schlüssel nicht null sind.

(Geerbt von NameObjectCollectionBase)
BaseRemove(String)

Entfernt die Einträge mit dem angegebenen Schlüssel aus der NameObjectCollectionBase-Instanz.

(Geerbt von NameObjectCollectionBase)
BaseRemoveAt(Int32)

Entfernt den Eintrag am angegebenen Index der NameObjectCollectionBase-Instanz.

(Geerbt von NameObjectCollectionBase)
BaseSet(Int32, Object)

Legt den Wert des Eintrags am angegebenen Index der NameObjectCollectionBase-Instanz fest.

(Geerbt von NameObjectCollectionBase)
BaseSet(String, Object)

Legt den Wert des ersten Eintrags mit dem angegebenen Schlüssel in der NameObjectCollectionBase-Instanz fest. Wenn der Schlüssel nicht vorhanden ist, wird der NameObjectCollectionBase-Instanz ein Eintrag mit dem angegebenen Wert und Schlüssel hinzugefügt.

(Geerbt von NameObjectCollectionBase)
Clear()

Löscht alle Cookies aus der Cookieauflistung.
CopyTo(Array, Int32)

Kopiert die Member der Cookieauflistung beginnend am angegebenen Index in ein Array.
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Get(Int32)

Gibt das HttpCookie-Element mit dem angegebenen Index aus der Cookieauflistung zurück.
Get(String)

Gibt das Cookie mit dem angegebenen Namen aus der Cookieauflistung zurück.
GetEnumerator()

Gibt einen Enumerator zurück, der die NameObjectCollectionBase durchläuft.

(Geerbt von NameObjectCollectionBase)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetKey(Int32)

Gibt den Schlüssel (den Namen) des Cookies am angegebenen numerischen Index zurück.
GetObjectData(SerializationInfo, StreamingContext)
Veraltet.

Implementiert die ISerializable-Schnittstelle und gibt die zum Serialisieren der NameObjectCollectionBase-Instanz erforderlichen Daten zurück.

(Geerbt von NameObjectCollectionBase)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnDeserialization(Object)

Implementiert die ISerializable-Schnittstelle und löst das Deserialisierungsereignis aus, sobald die Deserialisierung abgeschlossen ist.

(Geerbt von NameObjectCollectionBase)
Remove(String)

Entfernt das Cookie mit dem angegebenen Namen aus der Auflistung.
Set(HttpCookie)

Aktualisiert den Wert eines in einer Cookieauflistung vorhandenen Cookies.
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32)

Kopiert die gesamte NameObjectCollectionBase-Instanz in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays.

(Geerbt von NameObjectCollectionBase)
ICollection.IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf das NameObjectCollectionBase-Objekt synchronisiert (threadsicher) ist.

(Geerbt von NameObjectCollectionBase)
ICollection.SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf das NameObjectCollectionBase-Objekt synchronisiert werden kann.

(Geerbt von NameObjectCollectionBase)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.

Gilt für:

Weitere Informationen