HttpCookie Klasse

Definition

Stellt ein typsicheres Verfahren zum Erstellen und Bearbeiten einzelner HTTP-Cookies bereit.Provides a type-safe way to create and manipulate individual HTTP cookies.

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie im HttpRequest-Objekt nach einem Cookie namens DateCookieExample suchen.The following code example demonstrates how to check for a cookie named DateCookieExample in the HttpRequest object. Wenn das Cookie nicht gefunden wird, wird es erstellt und dem HttpResponse Objekt hinzugefügt.If the cookie is not found, it is created and added to the HttpResponse object. Das Cookie wird in 10 Minuten abläuft.The cookie is set to expire in 10 minutes.

<%@ 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.The HttpCookie class gets and sets properties of individual cookies. Die HttpCookieCollection-Klasse stellt Methoden zum Speichern, abrufen und Verwalten mehrerer Cookies bereit.The HttpCookieCollection class provides methods to store, retrieve, and manage multiple cookies.

ASP.NET enthält zwei systeminterne Cookie-Auflistungen.ASP.NET includes two intrinsic cookie collections. Die Auflistung, auf die über die Cookies-Auflistung des HttpRequest-Objekts zugegriffen wird, enthält Cookies, die vom Client an den Server im Cookie-Header übertragen werden.The collection accessed through the Cookies collection of the HttpRequest object contains cookies transmitted by the client to the server in the Cookie header. Die Auflistung, auf die über die Cookies-Auflistung des HttpResponse-Objekts zugegriffen wird, enthält neue Cookies, die auf dem Server erstellt und im Set-Cookie HTTP-Antwortheader an den Client übermittelt werden.The collection accessed through the Cookies collection of the HttpResponse object contains new cookies created on the server and transmitted to the client in the Set-Cookie HTTP response header.

Konstruktoren

HttpCookie(String)

Erstellt und benennt ein neues Cookie.Creates and names a new cookie.

HttpCookie(String, String)

Erstellt und benennt ein neues Cookie und weist diesem einen Wert zu.Creates, names, and assigns a value to a new cookie.

Eigenschaften

Domain

Ruft die Domäne ab, der das Cookie zugeordnet werden soll, oder legt diese fest.Gets or sets the domain to associate the cookie with.

Expires

Ruft das Ablaufdatum und die Ablaufzeit für das Cookie ab, oder legt diese fest.Gets or sets the expiration date and time for the cookie.

HasKeys

Ruft einen Wert ab, der angibt, ob ein Cookie über Unterschlüssel verfügt.Gets a value indicating whether a cookie has subkeys.

HttpOnly

Ruft einen Wert ab, der angibt, ob ein clientseitiges Skript auf ein Cookie zugreifen kann, oder liegt diesen fest.Gets or sets a value that specifies whether a cookie is accessible by client-side script.

Item[String]

Ruft eine Verknüpfung mit der Values-Eigenschaft ab.Gets a shortcut to the Values property. Diese Eigenschaft wird aus Gründen der Kompatibilität mit früheren Versionen von Active Server Pages (ASP) bereitgestellt.This property is provided for compatibility with previous versions of Active Server Pages (ASP).

Name

Ruft den Namen des Cookies ab oder legt diesen fest.Gets or sets the name of a cookie.

Path

Ruft den virtuellen Pfad ab, der mit dem aktuellen Cookie übertragen werden soll, oder legt diesen fest.Gets or sets the virtual path to transmit with the current cookie.

SameSite

Ruft den Wert des Attributs „SameSite“ des Cookies ab oder legt ihn fest.Gets or sets the value for the SameSite attribute of the cookie.

Secure

Ruft einen Wert ab, der angibt, ob das Cookie über Secure Sockets Layer (SSL) (d. h. ausschließlich über HTTPS) übertragen werden soll, oder legt diesen fest.Gets or sets a value indicating whether to transmit the cookie using Secure Sockets Layer (SSL)--that is, over HTTPS only.

Shareable

Bestimmt, ob dem Cookie die Beteiligung an der Zwischenspeicherung der Ausgabe erlaubt wird.Determines whether the cookie is allowed to participate in output caching.

Value

Ruft einen einzelnen Cookiewert ab oder legt diesen fest.Gets or sets an individual cookie value.

Values

Ruft eine Auflistung von Schlüssel-/Wert-Paaren ab, die in einem einzelnen Cookieobjekt enthalten sind.Gets a collection of key/value pairs that are contained within a single cookie object.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
TryParse(String, HttpCookie)

Konvertiert die angegebene Zeichenfolgendarstellung eines Cookies in deren HttpCookie-Entsprechung und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich ausgeführt wurde.Converts the specified string representation of a cookie into its HttpCookie equivalent and returns a value that indicates whether the conversion succeeded.

Gilt für:

Siehe auch