HttpCookieCollection 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 manipular cookies HTTP.

public ref class HttpCookieCollection sealed : System::Collections::Specialized::NameObjectCollectionBase

public sealed class HttpCookieCollection : System.Collections.Specialized.NameObjectCollectionBase

type HttpCookieCollection = class
    inherit NameObjectCollectionBase

Public NotInheritable Class HttpCookieCollection
Inherits NameObjectCollectionBase

Herencia: Object

NameObjectCollectionBase
HttpCookieCollection

Ejemplos

En el ejemplo de código siguiente se muestra cómo leer cookies mediante la Cookies propiedad del HttpRequest objeto y escribir cookies mediante la Cookies propiedad del HttpResponse objeto . Ambas propiedades devuelven HttpCookieCollection objetos. Si una de las dos cookies denominadas userName y lastVisit no están en la solicitud HTTP, se crean en la respuesta HTTP. Si existen las dos cookies, se muestran las propiedades de las cookies.

<%@ 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();
        // Check to see if cookies exist in HTTP request.
        if (Request.Cookies["userName"] == null && 
            Request.Cookies["lastVist"] == null)
        {
            Response.Cookies["userName"].Value = "user name";
            Response.Cookies["userName"].Expires = DateTime.Now.AddMinutes(20d);

            HttpCookie aCookie = new HttpCookie("lastVisit");
            aCookie.Value = DateTime.Now.ToString();
            aCookie.Expires = DateTime.Now.AddMinutes(20d);
            Response.Cookies.Add(aCookie);
            sb.Append("Two cookies added to response. " + 
                "Refresh the page to read the cookies.");
        }
        else
        {
            HttpCookieCollection cookies = Request.Cookies;
            for (int i = 0; i < cookies.Count; i++)
            {
                sb.Append("Name: " + cookies[i].Name + "<br/>");
                sb.Append("Value: " + cookies[i].Value + "<br/>");
                sb.Append("Expires: " + cookies[i].Expires.ToString() +
                          "<br/><br/>");
            }
        }
        Label1.Text = sb.ToString();
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpCookieCollection 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()
        ' Check to see if cookies exist in HTTP request.
        If (Request.Cookies("userName") Is Nothing AndAlso _
            Request.Cookies("lastVisit") Is Nothing) Then
            Response.Cookies("userName").Value = "user name"
            Response.Cookies("userName").Expires = DateTime.Now.AddMinutes(20D)

            Dim aCookie As HttpCookie
            aCookie = New HttpCookie("lastVisit")
            aCookie.Value = DateTime.Now.ToString()
            aCookie.Expires = DateTime.Now.AddMinutes(20D)
            Response.Cookies.Add(aCookie)
            sb.Append("Two cookies added to response. " & _
                "Refresh the page to read the cookies.")
        Else
            Dim cookies As HttpCookieCollection
            cookies = Request.Cookies
            For i As Integer = 0 To cookies.Count - 1
                sb.Append("Name: " & cookies(i).Name & "<br/>")
                sb.Append("Value: " & cookies(i).Value & "<br/>")
                sb.Append("Expires: " & cookies(i).Expires.ToString() & _
                          "<br/><br/>")
            Next

        End If
        Label1.Text = sb.ToString()
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpCookieCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1" runat="server"></asp:Label>    
    </div>
    </form>
</body>
</html>

Constructores

HttpCookieCollection()

Inicializa una nueva instancia de la clase HttpCookieCollection.

Propiedades

AllKeys	Obtiene una matriz de cadenas que contiene todas las claves (nombres de cookies) de la colección de cookies.
Count	Obtiene el número de pares de clave y valor incluidos en la instancia NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
IsReadOnly	Obtiene o establece un valor que indica si la instancia NameObjectCollectionBase es de solo lectura. (Heredado de NameObjectCollectionBase)
Item[Int32]	Obtiene la cookie con el índice numérico especificado de la colección de cookies.
Item[String]	Obtiene la cookie con el nombre especificado de la colección de cookies.
Keys	Obtiene una instancia NameObjectCollectionBase.KeysCollection que contiene todas las claves de la instancia NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)

Métodos

Add(HttpCookie)	Agrega la cookie especificada a la colección de cookies.
BaseAdd(String, Object)	Agrega una entrada con la clave y el valor especificados a la instancia NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
BaseClear()	Elimina todas las entradas de la instancia NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
BaseGet(Int32)	Obtiene el valor de la entrada que se encuentra en el índice especificado de la instancia NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
BaseGet(String)	Obtiene el valor de la primera entrada con la clave especificada desde la instancia NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
BaseGetAllKeys()	Devuelve una matriz String que contiene todas las claves de la instancia NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
BaseGetAllValues()	Devuelve una matriz Object que contiene todos los valores de la instancia NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
BaseGetAllValues(Type)	Devuelve una matriz del tipo especificado que contiene todos los valores de la instancia NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
BaseGetKey(Int32)	Obtiene la clave de la entrada que se encuentra en el índice especificado de la instancia NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
BaseHasKeys()	Obtiene un valor que indica si la instancia NameObjectCollectionBase contiene entradas cuyas claves no son `null`. (Heredado de NameObjectCollectionBase)
BaseRemove(String)	Quita las entradas con la clave especificada de la instancia de NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
BaseRemoveAt(Int32)	Elimina la entrada que se encuentra en el índice especificado de la instancia NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
BaseSet(Int32, Object)	Establece el valor de la entrada que se encuentra en el índice especificado de la instancia NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
BaseSet(String, Object)	Establece el valor de la primera entrada con la clave especificada de la instancia NameObjectCollectionBase, si la encuentra; en caso contrario, agrega una entrada con la clave y el valor especificados a la instancia NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
Clear()	Borra todas las cookies de la colección de cookies.
CopyTo(Array, Int32)	Copia los miembros de la colección de cookies en un objeto Array a partir del índice especificado de la matriz.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Get(Int32)	Devuelve el objeto HttpCookie con el índice especificado de la colección de cookies.
Get(String)	Devuelve la cookie con el nombre especificado de la colección de cookies.
GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetKey(Int32)	Devuelve la clave (el nombre) de la cookie en el índice numérico especificado.
GetObjectData(SerializationInfo, StreamingContext)	Implementa la interfaz de ISerializable y devuelve los datos necesarios para serializar la instancia de NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnDeserialization(Object)	Implementa la interfaz ISerializable y genera el evento de deserialización cuando esta ha finalizado. (Heredado de NameObjectCollectionBase)
Remove(String)	Quita la cookie con el nombre especificado de la colección.
Set(HttpCookie)	Actualiza el valor de una cookie existente en una colección de cookies.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32)	Copia la totalidad de NameObjectCollectionBase en una matriz Array unidimensional compatible, comenzando en el índice especificado de la matriz de destino. (Heredado de NameObjectCollectionBase)
ICollection.IsSynchronized	Obtiene un valor que indica si el acceso al objeto NameObjectCollectionBase está sincronizado (es seguro para subprocesos). (Heredado de NameObjectCollectionBase)
ICollection.SyncRoot	Obtiene un objeto que puede utilizarse para sincronizar el acceso al objeto NameObjectCollectionBase. (Heredado de NameObjectCollectionBase)

Métodos de extensión

Cast<TResult>(IEnumerable)	Convierte los elementos de IEnumerable en el tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de IEnumerable en función de un tipo especificado.
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte una interfaz IEnumerable en IQueryable.

Se aplica a

Consulte también

HttpCookie