HttpCookie Clase

Definición

Espacio de nombres:
System.Web
Ensamblado:
System.Web.dll

Proporciona una manera segura de tipos para crear y manipular cookies HTTP individuales.

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

Ejemplos

En el ejemplo de código siguiente se muestra cómo comprobar si hay una cookie denominada DateCookieExample en el HttpRequest objeto . Si no se encuentra la cookie, se crea y se agrega al HttpResponse objeto . La cookie está establecida para expirar en 10 minutos.

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

Comentarios

La HttpCookie clase obtiene y establece las propiedades de las cookies individuales. La HttpCookieCollection clase proporciona métodos para almacenar, recuperar y administrar varias cookies.

ASP.NET incluye dos colecciones intrínsecas de cookies. La colección a la que se accede a través de la CookiesHttpRequest colección del objeto contiene cookies transmitidas por el cliente al servidor en el Cookie encabezado . La colección a la que se accede a través de la CookiesHttpResponse colección del objeto contiene nuevas cookies creadas en el servidor y transmitidas al cliente en el Set-Cookie encabezado de respuesta HTTP.

Constructores

Nombre Description
HttpCookie(String, String)

Crea, asigna un valor a una nueva cookie.
HttpCookie(String)

Crea y asigna un nombre a una nueva cookie.

Propiedades

Nombre Description
Domain

Obtiene o establece el dominio al que se va a asociar la cookie.
Expires

Obtiene o establece la fecha y hora de expiración de la cookie.
HasKeys

Obtiene un valor que indica si una cookie tiene subclaves.
HttpOnly

Obtiene o establece un valor que especifica si un script del lado cliente puede acceder a una cookie.
Item[String]

Obtiene un acceso directo a la Values propiedad . Esta propiedad se proporciona para la compatibilidad con versiones anteriores de Active Server Pages (ASP).
Name

Obtiene o establece el nombre de una cookie.
Path

Obtiene o establece la ruta de acceso virtual que se va a transmitir con la cookie actual.
SameSite

Obtiene o establece el valor del atributo SameSite de la cookie.
Secure

Obtiene o establece un valor que indica si se debe transmitir la cookie mediante capa de sockets seguros (SSL), es decir, solo a través de HTTPS.
Shareable

Determina si la cookie puede participar en el almacenamiento en caché de salida.
Value

Obtiene o establece un valor de cookie individual.
Values

Obtiene una colección de pares clave-valor contenidos en un único objeto de cookie.

Métodos

Nombre Description
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetHashCode()

Actúa como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
TryParse(String, HttpCookie)

Convierte la representación de cadena especificada de una cookie en su HttpCookie equivalente y devuelve un valor que indica si la conversión se realizó correctamente.

Se aplica a

Consulte también