HttpCookieCollection Classe

Définition

Espace de noms:: System.Web

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit un moyen sécurisé de manipuler des 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

Héritage: Object

NameObjectCollectionBase
HttpCookieCollection

Exemples

L’exemple de code suivant montre comment lire des cookies à l’aide de la Cookies propriété de l’objet HttpRequest et écrire des cookies à l’aide de la Cookies propriété de l’objet HttpResponse . Les deux propriétés retournent HttpCookieCollection des objets. Si l’un des deux cookies nommés userName et lastVisit ne se trouve pas dans la requête HTTP, ils sont créés dans la réponse HTTP. Si les deux cookies existent, les propriétés des cookies sont affichées.

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

Constructeurs

Nom	Description
HttpCookieCollection()	Initialise une nouvelle instance de la classe HttpCookieCollection.

Propriétés

Nom	Description
AllKeys	Obtient un tableau de chaînes contenant toutes les clés (noms de cookies) dans la collection de cookies.
Count	Obtient le nombre de paires clé/valeur contenues dans l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
IsReadOnly	Obtient ou définit une valeur indiquant si l’instance NameObjectCollectionBase est en lecture seule. (Hérité de NameObjectCollectionBase)
Item[Int32]	Obtient le cookie avec l’index numérique spécifié de la collection de cookies.
Item[String]	Obtient le cookie avec le nom spécifié de la collection de cookies.
Keys	Obtient une NameObjectCollectionBase.KeysCollection instance qui contient toutes les clés de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)

Méthodes

Nom	Description
Add(HttpCookie)	Ajoute le cookie spécifié à la collection de cookies.
BaseAdd(String, Object)	Ajoute une entrée avec la clé et la valeur spécifiées dans l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseClear()	Supprime toutes les entrées de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseGet(Int32)	Obtient la valeur de l’entrée à l’index spécifié de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseGet(String)	Obtient la valeur de la première entrée avec la clé spécifiée de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseGetAllKeys()	Retourne un String tableau qui contient toutes les clés de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseGetAllValues()	Retourne un Object tableau qui contient toutes les valeurs de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseGetAllValues(Type)	Retourne un tableau du type spécifié qui contient toutes les valeurs de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseGetKey(Int32)	Obtient la clé de l’entrée à l’index spécifié de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseHasKeys()	Obtient une valeur indiquant si l’instance NameObjectCollectionBase contient des entrées dont les clés ne sont pas `null`. (Hérité de NameObjectCollectionBase)
BaseRemove(String)	Supprime les entrées avec la clé spécifiée de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseRemoveAt(Int32)	Supprime l’entrée à l’index spécifié de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseSet(Int32, Object)	Définit la valeur de l’entrée à l’index spécifié de l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
BaseSet(String, Object)	Définit la valeur de la première entrée avec la clé spécifiée dans l’instance NameObjectCollectionBase , si elle est trouvée ; sinon, ajoute une entrée avec la clé et la valeur spécifiées dans l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
Clear()	Efface tous les cookies de la collection de cookies.
CopyTo(Array, Int32)	Copie les membres de la collection de cookies vers un Array début à l’index spécifié du tableau.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
Get(Int32)	Retourne l’élément HttpCookie avec l’index spécifié de la collection de cookies.
Get(String)	Retourne le cookie avec le nom spécifié de la collection de cookies.
GetEnumerator()	Retourne un énumérateur qui itère dans le NameObjectCollectionBase. (Hérité de NameObjectCollectionBase)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetKey(Int32)	Retourne la clé (nom) du cookie à l’index numérique spécifié.
GetObjectData(SerializationInfo, StreamingContext)	Obsolète. Implémente l’interface ISerializable et retourne les données nécessaires pour sérialiser l’instance NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnDeserialization(Object)	Implémente l’interface ISerializable et déclenche l’événement de désérialisation lorsque la désérialisation est terminée. (Hérité de NameObjectCollectionBase)
Remove(String)	Supprime le cookie avec le nom spécifié de la collection.
Set(HttpCookie)	Met à jour la valeur d’un cookie existant dans une collection de cookies.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

Nom	Description
ICollection.CopyTo(Array, Int32)	Copie l’intégralité NameObjectCollectionBase dans une dimension unidimensionnelle Arraycompatible, en commençant à l’index spécifié du tableau cible. (Hérité de NameObjectCollectionBase)
ICollection.IsSynchronized	Obtient une valeur indiquant si l’accès à l’objet NameObjectCollectionBase est synchronisé (thread safe). (Hérité de NameObjectCollectionBase)
ICollection.SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à l’objet NameObjectCollectionBase . (Hérité de NameObjectCollectionBase)

Méthodes d’extension

Nom	Description
AsParallel(IEnumerable)	Active la parallélisation d’une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.
Cast<TResult>(IEnumerable)	Convertit les éléments d’un IEnumerable en type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d’une IEnumerable en fonction d’un type spécifié.

S’applique à

Voir aussi

HttpCookie

Commentaires

Cette page a-t-elle été utile ?