HttpCookieCollection Clase

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 una forma segura 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

Nombre	Description
HttpCookieCollection()	Inicializa una nueva instancia de la clase HttpCookieCollection.

Propiedades

Nombre	Description
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 clave-valor contenidos en la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)
IsReadOnly	Obtiene o establece un valor que indica si la NameObjectCollectionBase instancia 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 NameObjectCollectionBase.KeysCollection instancia que contiene todas las claves de la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)

Métodos

Nombre	Description
Add(HttpCookie)	Agrega la cookie especificada a la recopilación de cookies.
BaseAdd(String, Object)	Agrega una entrada con la clave y el valor especificados en la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)
BaseClear()	Quita todas las entradas de la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)
BaseGet(Int32)	Obtiene el valor de la entrada en el índice especificado de la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)
BaseGet(String)	Obtiene el valor de la primera entrada con la clave especificada de la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)
BaseGetAllKeys()	Devuelve una String matriz que contiene todas las claves de la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)
BaseGetAllValues()	Devuelve una Object matriz que contiene todos los valores de la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)
BaseGetAllValues(Type)	Devuelve una matriz del tipo especificado que contiene todos los valores de la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)
BaseGetKey(Int32)	Obtiene la clave de la entrada en el índice especificado de la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)
BaseHasKeys()	Obtiene un valor que indica si la NameObjectCollectionBase instancia contiene entradas cuyas claves no `null`son . (Heredado de NameObjectCollectionBase)
BaseRemove(String)	Quita las entradas con la clave especificada de la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)
BaseRemoveAt(Int32)	Quita la entrada en el índice especificado de la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)
BaseSet(Int32, Object)	Establece el valor de la entrada en el índice especificado de la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)
BaseSet(String, Object)	Establece el valor de la primera entrada con la clave especificada en la NameObjectCollectionBase instancia, si se encuentra; de lo contrario, agrega una entrada con la clave y el valor especificados en la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)
Clear()	Borra todas las cookies de la recopilación de cookies.
CopyTo(Array, Int32)	Copia los miembros de la colección de cookies en un Array principio en el índice especificado de la matriz.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
Get(Int32)	Devuelve el HttpCookie elemento 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 .NameObjectCollectionBase (Heredado de NameObjectCollectionBase)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetKey(Int32)	Devuelve la clave (nombre) de la cookie en el índice numérico especificado.
GetObjectData(SerializationInfo, StreamingContext)	Obsoletos. Implementa la ISerializable interfaz y devuelve los datos necesarios para serializar la NameObjectCollectionBase instancia. (Heredado de NameObjectCollectionBase)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
OnDeserialization(Object)	Implementa la ISerializable interfaz y genera el evento de deserialización cuando se completa la deserialización. (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 recopilación de cookies.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

Nombre	Description
ICollection.CopyTo(Array, Int32)	Copia todo en NameObjectCollectionBase una unidimensional Arraycompatible, empezando por el índice especificado de la matriz de destino. (Heredado de NameObjectCollectionBase)
ICollection.IsSynchronized	Obtiene un valor que indica si el NameObjectCollectionBase acceso al objeto está sincronizado (seguro para subprocesos). (Heredado de NameObjectCollectionBase)
ICollection.SyncRoot	Obtiene un objeto que se puede usar para sincronizar el acceso al NameObjectCollectionBase objeto . (Heredado de NameObjectCollectionBase)

Métodos de extensión

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

Se aplica a

Consulte también

HttpCookie

Comentarios

Resultoulle útil esta páxina?