HttpCookie Clase

Referencia

Definición

Espacio de nombres:: System.Web

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Proporciona un método con seguridad 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 buscar una cookie denominada DateCookieExample en el HttpRequest objeto . Si no se encuentra la cookie, se crea y se agrega al HttpResponse objeto . La cookie se establece para que expire 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 Cookies HttpRequest 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 Cookies HttpResponse colección del objeto contiene nuevas cookies creadas en el servidor y transmitidas al cliente en el Set-Cookie encabezado de respuesta HTTP.

Constructores

HttpCookie(String)	Crea una nueva cookie y le asigna un nombre.
HttpCookie(String, String)	Crea una nueva cookie y le asigna un nombre y un valor.

Propiedades

Domain	Obtiene o establece el dominio al que se asociará la cookie.
Expires	Obtiene o establece la fecha y la 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 se puede obtener acceso a una cookie mediante script de cliente.
Item[String]	Obtiene un acceso directo a la propiedad Values. Se proporciona esta propiedad para que exista compatibilidad con versiones anteriores de las páginas Active Server (ASP).
Name	Obtiene o establece el nombre de una cookie.
Path	Obtiene o establece la ruta de acceso virtual que se 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 va a transmitir la cookie a través de Secure Sockets Layer (SSL), es decir, sólo a través de HTTPS.
Shareable	Determina si la cookie puede participar en el almacenamiento en caché de los resultados.
Value	Obtiene o establece un valor de cookie individual.
Values	Obtiene una colección de pares de clave/valor que se incluyen en un solo objeto cookie.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve 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 Object actual. (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 el objeto HttpCookie equivalente y devuelve un valor que indica si la conversión se realizó correctamente.

Se aplica a