HttpCookie HttpCookie HttpCookie HttpCookie Class

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
HttpCookieHttpCookieHttpCookieHttpCookie

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie DateCookieExample HttpRequest im-Objekt auf ein Cookie namens überprüft wird.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 Cookies AuflistungCookie , auf die über die- HttpRequest Auflistung des-Objekts zugegriffen wird, enthält Cookies, die vom Client an den Server im-Header übertragen werdenThe 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 Cookies ,aufHttpResponse die über die-Auflistung des-Objekts zugegriffen wird, enthält neue Cookies, die auf dem Server erstellt und im HTTP-AntwortheaderandenClientübermitteltwerdenSet-CookieThe 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) HttpCookie(String) HttpCookie(String) HttpCookie(String)

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

HttpCookie(String, String) HttpCookie(String, String) HttpCookie(String, String) 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 Domain Domain 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 Expires Expires 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 HasKeys HasKeys 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 HttpOnly HttpOnly 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] Item[String] Item[String] 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 Name Name Name

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

Path Path Path 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 SameSite SameSite 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 Secure Secure 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 Shareable Shareable 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 Value Value Value

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

Values Values Values 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) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)
TryParse(String, HttpCookie) TryParse(String, HttpCookie) TryParse(String, HttpCookie) 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