HttpCookie Klasse

Definition

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

Bietet eine typsichere Möglichkeit zum Erstellen und Bearbeiten einzelner HTTP-Cookies.

public ref class HttpCookie sealed
public sealed class HttpCookie
type HttpCookie = class
Public NotInheritable Class HttpCookie
Vererbung
Object
HttpCookie

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie nach einem Cookie suchen, das DateCookieExample im Objekt benannt istHttpRequest. Wenn das Cookie nicht gefunden wird, wird es erstellt und dem HttpResponse Objekt hinzugefügt. Das Cookie wird in 10 Minuten ablaufen.

<%@ 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();
        // Get cookie from the current request.
        HttpCookie cookie = Request.Cookies.Get("DateCookieExample");
        
        // Check if cookie exists in the current request.
        if (cookie == null)
        {
            sb.Append("Cookie was not received from the client. ");
            sb.Append("Creating cookie to add to the response. <br/>");
            // Create cookie.
            cookie = new HttpCookie("DateCookieExample");
            // Set value of cookie to current date time.
            cookie.Value = DateTime.Now.ToString();
            // Set cookie to expire in 10 minutes.
            cookie.Expires = DateTime.Now.AddMinutes(10d);
            // Insert the cookie in the current HttpResponse.
            Response.Cookies.Add(cookie);
        }
        else
        {
            sb.Append("Cookie retrieved from client. <br/>");
            sb.Append("Cookie Name: " + cookie.Name + "<br/>");
            sb.Append("Cookie Value: " + cookie.Value + "<br/>");
            sb.Append("Cookie Expiration Date: " + 
                cookie.Expires.ToString() + "<br/>");
        }
        Label1.Text = sb.ToString();
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpCookie 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()
        ' Get cookie from current request.
        Dim cookie As HttpCookie
        cookie = Request.Cookies.Get("DateCookieExample")
        
        ' Check if cookie exists in the current request
        If (cookie Is Nothing) Then
            sb.Append("Cookie was not received from the client. ")
            sb.Append("Creating cookie to add to the response. <br/>")
            ' Create cookie.
            cookie = New HttpCookie("DateCookieExample")
            ' Set value of cookie to current date time.
            cookie.Value = DateTime.Now.ToString()
            ' Set cookie to expire in 10 minutes.
            cookie.Expires = DateTime.Now.AddMinutes(10D)
            ' Insert the cookie in the current HttpResponse.
            Response.Cookies.Add(cookie)
        Else
            sb.Append("Cookie retrieved from client. <br/>")
            sb.Append("Cookie Name: " + cookie.Name + "<br/>")
            sb.Append("Cookie Value: " + cookie.Value + "<br/>")
            sb.Append("Cookie Expiration Date: " & _
                cookie.Expires.ToString() & "<br/>")
        End If
        Label1.Text = sb.ToString()

    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpCookie Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1" runat="server"></asp:Label>    
    </div>
    </form>
</body>
</html>

Hinweise

Die HttpCookie Klasse ruft die Eigenschaften einzelner Cookies ab und legt sie fest. Die HttpCookieCollection Klasse bietet Methoden zum Speichern, Abrufen und Verwalten mehrerer Cookies.

ASP.NET umfasst zwei systeminterne Cookiesammlungen. Die Sammlung, auf die über die Cookies Sammlung des HttpRequest Objekts zugegriffen wird, enthält Cookies, die vom Client an den Server in der Cookie Kopfzeile übermittelt werden. Die Sammlung, auf die über die Cookies Auflistung des HttpResponse Objekts zugegriffen wird, enthält neue Cookies, die auf dem Server erstellt und an den Client im Set-Cookie HTTP-Antwortheader übertragen werden.

Konstruktoren

Name Beschreibung
HttpCookie(String, String)

Erstellt, benannt und weist einem neuen Cookie einen Wert zu.
HttpCookie(String)

Erstellt und benennt ein neues Cookie.

Eigenschaften

Name Beschreibung
Domain

Ruft die Domäne ab, der das Cookie zugeordnet werden soll, oder legt sie fest.
Expires

Dient zum Abrufen oder Festlegen des Ablaufdatums und der Uhrzeit für das Cookie.
HasKeys

Ruft einen Wert ab, der angibt, ob ein Cookie Unterschlüssel enthält.
HttpOnly

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Cookie über ein clientseitiges Skript zugänglich ist.
Item[String]

Ruft eine Verknüpfung mit der Values Eigenschaft ab. Diese Eigenschaft wird zur Kompatibilität mit früheren Versionen von Active Server Pages (ASP) bereitgestellt.
Name

Dient zum Abrufen oder Festlegen des Namens eines Cookies.
Path

Ruft den virtuellen Pfad ab, der mit dem aktuellen Cookie übertragen werden soll, oder legt diesen fest.
SameSite

Dient zum Abrufen oder Festlegen des Werts für das SameSite-Attribut des Cookies.
Secure

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Cookie mit Secure Sockets Layer (SSL) übertragen werden soll , d. h. nur über HTTPS.
Shareable

Bestimmt, ob das Cookie an der Ausgabezwischenspeicherung teilnehmen darf.
Value

Dient zum Abrufen oder Festlegen eines einzelnen Cookiewerts.
Values

Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die in einem einzelnen Cookie-Objekt enthalten sind.

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

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

(Geerbt von Object)
TryParse(String, HttpCookie)

Konvertiert die angegebene Zeichenfolgendarstellung eines Cookies in seine HttpCookie Entsprechung und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich war.

Gilt für:

Weitere Informationen