HttpCookie Classe

Definizione

Specifica una modalità indipendente dai tipi per creare e modificare singoli cookie HTTP.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
Ereditarietà
HttpCookie

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come verificare la presenza di un cookie denominato DateCookieExample nell' HttpRequest oggetto.The following code example demonstrates how to check for a cookie named DateCookieExample in the HttpRequest object. Se il cookie non viene trovato, viene creato e aggiunto all' HttpResponse oggetto.If the cookie is not found, it is created and added to the HttpResponse object. Il cookie è impostato in modo da scadere tra 10 minuti.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>

Commenti

La HttpCookie classe ottiene e imposta le proprietà dei singoli cookie.The HttpCookie class gets and sets properties of individual cookies. La HttpCookieCollection classe fornisce metodi per archiviare, recuperare e gestire più cookie.The HttpCookieCollection class provides methods to store, retrieve, and manage multiple cookies.

ASP.NET include due raccolte di cookie intrinseci.ASP.NET includes two intrinsic cookie collections. La raccolta a cui si accede tramite la Cookies raccolta dell' HttpRequest oggetto contiene i cookie trasmessi dal client al server nell' Cookie intestazione.The collection accessed through the Cookies collection of the HttpRequest object contains cookies transmitted by the client to the server in the Cookie header. La raccolta a cui si accede tramite la Cookies raccolta dell' HttpResponse oggetto contiene nuovi cookie creati nel server e trasmessi al client nell' Set-Cookie intestazione della risposta http.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.

Costruttori

HttpCookie(String)

Crea e assegna un nome a un nuovo cookie.Creates and names a new cookie.

HttpCookie(String, String)

Crea e assegna un nome e un valore a un nuovo cookie.Creates, names, and assigns a value to a new cookie.

Proprietà

Domain

Ottiene o imposta il dominio a cui associare il cookie.Gets or sets the domain to associate the cookie with.

Expires

Ottiene o imposta la data e l'ora di scadenza per il cookie.Gets or sets the expiration date and time for the cookie.

HasKeys

Ottiene un valore che indica se il cookie ha sottochiavi.Gets a value indicating whether a cookie has subkeys.

HttpOnly

Ottiene o imposta un valore che specifica se un cookie è accessibile da parte di script del lato client.Gets or sets a value that specifies whether a cookie is accessible by client-side script.

Item[String]

Ottiene un collegamento alla proprietà Values.Gets a shortcut to the Values property. Questa proprietà viene offerta per supportare la compatibilità con le versioni precedenti di ASP (Active Server Pages).This property is provided for compatibility with previous versions of Active Server Pages (ASP).

Name

Ottiene o imposta il nome di un cookie.Gets or sets the name of a cookie.

Path

Ottiene o imposta il percorso virtuale da trasmettere con il cookie corrente.Gets or sets the virtual path to transmit with the current cookie.

SameSite

Ottiene o imposta il valore dell'attributo SameSite del cookie.Gets or sets the value for the SameSite attribute of the cookie.

Secure

Ottiene o imposta un valore che indica se trasmettere il cookie mediante SSL (Secure Sockets Layer), ossia solo su HTTPS.Gets or sets a value indicating whether to transmit the cookie using Secure Sockets Layer (SSL)--that is, over HTTPS only.

Shareable

Determina se al cookie è consentito partecipare alla memorizzazione nella cache dell'output.Determines whether the cookie is allowed to participate in output caching.

Value

Ottiene o imposta un singolo valore di cookie.Gets or sets an individual cookie value.

Values

Ottiene una raccolta di coppie chiave/valore contenute in un singolo oggetto cookie.Gets a collection of key/value pairs that are contained within a single cookie object.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
TryParse(String, HttpCookie)

Converte la rappresentazione di stringa specificata di un cookie nell'equivalente HttpCookie e restituisce un valore che indica se la conversione è stata eseguita correttamente.Converts the specified string representation of a cookie into its HttpCookie equivalent and returns a value that indicates whether the conversion succeeded.

Si applica a

Vedi anche