HttpCookieCollection Třída

Definice

Obor názvů:: System.Web

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje typově bezpečný způsob manipulace se soubory cookie 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

Dědičnost: Object

NameObjectCollectionBase
HttpCookieCollection

Příklady

Následující příklad kódu ukazuje, jak číst soubory cookie pomocí Cookies vlastnosti objektu HttpRequest a zapisovat soubory cookie pomocí Cookies vlastnosti objektu HttpResponse . Obě vlastnosti vrací HttpCookieCollection objekty. Pokud se některý ze dvou souborů cookie jmenuje userName a lastVisit není v požadavku HTTP, vytvoří se v odpovědi HTTP. Pokud tyto dva soubory cookie existují, zobrazí se vlastnosti souborů cookie.

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

Konstruktory

Name	Description
HttpCookieCollection()	Inicializuje novou instanci HttpCookieCollection třídy.

Vlastnosti

Name	Description
AllKeys	Získá řetězcové pole obsahující všechny klíče (názvy souborů cookie) v kolekci souborů cookie.
Count	Získá počet párů klíč/hodnota obsažených NameObjectCollectionBase v instanci. (Zděděno od NameObjectCollectionBase)
IsReadOnly	Získá nebo nastaví hodnotu určující, zda NameObjectCollectionBase instance je jen pro čtení. (Zděděno od NameObjectCollectionBase)
Item[Int32]	Získá soubor cookie se zadaným číselným indexem z kolekce souborů cookie.
Item[String]	Získá soubor cookie se zadaným názvem z kolekce souborů cookie.
Keys	Získá NameObjectCollectionBase.KeysCollection instanci, která obsahuje všechny klíče v NameObjectCollectionBase instanci. (Zděděno od NameObjectCollectionBase)

Metody

Name	Description
Add(HttpCookie)	Přidá zadaný soubor cookie do kolekce souborů cookie.
BaseAdd(String, Object)	Přidá položku se zadaným klíčem a hodnotou do NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseClear()	Odebere všechny položky z NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseGet(Int32)	Získá hodnotu položky v zadaném indexu NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseGet(String)	Získá hodnotu první položky se zadaným klíčem z NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseGetAllKeys()	String Vrátí pole, které obsahuje všechny klíče v NameObjectCollectionBase instanci. (Zděděno od NameObjectCollectionBase)
BaseGetAllValues()	Object Vrátí pole, které obsahuje všechny hodnoty v NameObjectCollectionBase instanci. (Zděděno od NameObjectCollectionBase)
BaseGetAllValues(Type)	Vrátí pole zadaného typu, které obsahuje všechny hodnoty v NameObjectCollectionBase instanci. (Zděděno od NameObjectCollectionBase)
BaseGetKey(Int32)	Získá klíč položky v zadaném indexu NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseHasKeys()	Získá hodnotu určující, zda NameObjectCollectionBase instance obsahuje položky, jejichž klíče nejsou `null`. (Zděděno od NameObjectCollectionBase)
BaseRemove(String)	Odebere položky se zadaným klíčem z NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseRemoveAt(Int32)	Odebere položku v zadaném indexu NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseSet(Int32, Object)	Nastaví hodnotu položky na zadaném indexu NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
BaseSet(String, Object)	Nastaví hodnotu první položky se zadaným klíčem v NameObjectCollectionBase instanci, pokud je nalezena; v opačném případě přidá položku se zadaným klíčem a hodnotou do NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
Clear()	Vymaže všechny soubory cookie z kolekce souborů cookie.
CopyTo(Array, Int32)	Zkopíruje členy kolekce souborů cookie na Array začátek zadaného indexu pole.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
Get(Int32)	HttpCookie Vrátí položku se zadaným indexem z kolekce souborů cookie.
Get(String)	Vrátí soubor cookie se zadaným názvem z kolekce souborů cookie.
GetEnumerator()	Vrátí enumerátor, který iteruje přes NameObjectCollectionBase. (Zděděno od NameObjectCollectionBase)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetKey(Int32)	Vrátí klíč (název) souboru cookie v zadaném číselném indexu.
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Implementuje ISerializable rozhraní a vrací data potřebná k serializaci NameObjectCollectionBase instance. (Zděděno od NameObjectCollectionBase)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnDeserialization(Object)	Implementuje ISerializable rozhraní a vyvolá deserializační událost po dokončení deserializace. (Zděděno od NameObjectCollectionBase)
Remove(String)	Odebere soubor cookie se zadaným názvem z kolekce.
Set(HttpCookie)	Aktualizuje hodnotu existujícího souboru cookie v kolekci souborů cookie.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

Name	Description
ICollection.CopyTo(Array, Int32)	Zkopíruje celý NameObjectCollectionBase soubor do kompatibilního jednorozměrného Array, počínaje zadaným indexem cílového pole. (Zděděno od NameObjectCollectionBase)
ICollection.IsSynchronized	Získá hodnotu označující, zda je přístup k objektu NameObjectCollectionBase synchronizován (bezpečné vlákno). (Zděděno od NameObjectCollectionBase)
ICollection.SyncRoot	Získá objekt, který lze použít k synchronizaci přístupu k objektu NameObjectCollectionBase . (Zděděno od NameObjectCollectionBase)

Metody rozšíření

Name	Description
AsParallel(IEnumerable)	Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)	Převede IEnumerable na IQueryable.
Cast<TResult>(IEnumerable)	Přetypuje prvky IEnumerable na zadaný typ.
OfType<TResult>(IEnumerable)	Filtruje prvky IEnumerable na základě zadaného typu.

Platí pro

Viz také

HttpCookie

Váš názor

Byla tato stránka užitečná?