HttpCookieCollection Класс

Определение

Предоставляет типобезопасный способ работы с файлами cookie по протоколу HTTP.Provides a type-safe way to manipulate HTTP cookies.

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
Наследование
HttpCookieCollection

Примеры

В следующем примере кода показано, как читать файлы cookie с Cookies помощью свойства HttpRequest объекта Cookies и записывать файлы cookie, HttpResponse используя свойство объекта.The following code example demonstrates how to read cookies using the Cookies property of the HttpRequest object and write cookies using the Cookies property of the HttpResponse object. Оба свойства возвращают HttpCookieCollection объекты.Both properties return HttpCookieCollection objects. Если один из двух файлов cookie userName с lastVisit именами и не находится в HTTP-запросе, то они создаются в HTTP-ответе.If either of two cookies named userName and lastVisit are not in the HTTP request, then they are created in the HTTP response. Если два файла cookie существуют, отображаются свойства файлов cookie.If the two cookies exist, the properties of the cookies are displayed.

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

Конструкторы

HttpCookieCollection()

Инициализирует новый экземпляр класса HttpCookieCollection.Initializes a new instance of the HttpCookieCollection class.

Свойства

AllKeys

Получает массив строк, содержащий все ключи (имена файлов Cookie) коллекции файлов Cookie.Gets a string array containing all the keys (cookie names) in the cookie collection.

Count

Возвращает число пар "ключ-значение", содержащихся в экземпляре класса NameObjectCollectionBase.Gets the number of key/value pairs contained in the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)
IsReadOnly

Возвращает или задает значение, указывающее, является ли экземпляр класса NameObjectCollectionBase доступным только для чтения.Gets or sets a value indicating whether the NameObjectCollectionBase instance is read-only.

(Унаследовано от NameObjectCollectionBase)
Item[Int32]

Получает файл Cookie с указанным числовым индексом из коллекции файлов Cookie.Gets the cookie with the specified numerical index from the cookie collection.

Item[String]

Получает файл Cookie с указанным именем из коллекции файлов Cookie.Gets the cookie with the specified name from the cookie collection.

Keys

Возвращает экземпляр класса NameObjectCollectionBase.KeysCollection, который содержит все ключи экземпляра класса NameObjectCollectionBase.Gets a NameObjectCollectionBase.KeysCollection instance that contains all the keys in the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)

Методы

Add(HttpCookie)

Добавляет указанный файл cookie в коллекцию.Adds the specified cookie to the cookie collection.

BaseAdd(String, Object)

Добавляет запись с указанным ключом и значением в экземпляр класса NameObjectCollectionBase.Adds an entry with the specified key and value into the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)
BaseClear()

Удаляет все записи из экземпляра класса NameObjectCollectionBase.Removes all entries from the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)
BaseGet(Int32)

Возвращает значение записи по указанному индексу экземпляра класса NameObjectCollectionBase.Gets the value of the entry at the specified index of the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)
BaseGet(String)

Возвращает значение первой записи с указанным ключом из экземпляра класса NameObjectCollectionBase.Gets the value of the first entry with the specified key from the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)
BaseGetAllKeys()

Возвращает массив String, который содержит все ключи экземпляра класса NameObjectCollectionBase.Returns a String array that contains all the keys in the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)
BaseGetAllValues()

Возвращает массив Object, который содержит все значения экземпляра класса NameObjectCollectionBase.Returns an Object array that contains all the values in the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)
BaseGetAllValues(Type)

Возвращает массив указанного типа, который содержит все значения экземпляра класса NameObjectCollectionBase.Returns an array of the specified type that contains all the values in the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)
BaseGetKey(Int32)

Возвращает ключ записи по указанному индексу в экземпляре класса NameObjectCollectionBase.Gets the key of the entry at the specified index of the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)
BaseHasKeys()

Возвращает значение, показывающее, содержит ли экземпляр класса NameObjectCollectionBase записи, в которых значение ключа отлично от null.Gets a value indicating whether the NameObjectCollectionBase instance contains entries whose keys are not null.

(Унаследовано от NameObjectCollectionBase)
BaseRemove(String)

Удаляет записи с указанным ключом из экземпляра класса NameObjectCollectionBase.Removes the entries with the specified key from the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)
BaseRemoveAt(Int32)

Удаляет запись по указанному индексу в экземпляре класса NameObjectCollectionBase.Removes the entry at the specified index of the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)
BaseSet(Int32, Object)

Задает значение записи по указанному индексу экземпляра класса NameObjectCollectionBase.Sets the value of the entry at the specified index of the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)
BaseSet(String, Object)

Задает значение первой записи с указанным ключом в экземпляре класса NameObjectCollectionBase, если ключ найден; в противном случае добавляет запись с указанным ключом и значением в экземпляр класса NameObjectCollectionBase.Sets the value of the first entry with the specified key in the NameObjectCollectionBase instance, if found; otherwise, adds an entry with the specified key and value into the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)
Clear()

Удаляет все файлы cookie из коллекции файлов cookie.Clears all cookies from the cookie collection.

CopyTo(Array, Int32)

Копирует членов коллекции файлов cookie в Array, начинающийся с указанного индекса массива.Copies members of the cookie collection to an Array beginning at the specified index of the array.

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
Get(Int32)

Возвращает элемент HttpCookie с указанным индексом из коллекции файлов cookie.Returns the HttpCookie item with the specified index from the cookie collection.

Get(String)

Возвращает файл Cookie с указанным именем из коллекции файлов Cookie.Returns the cookie with the specified name from the cookie collection.

GetEnumerator()

Возвращает перечислитель, осуществляющий перебор элементов списка NameObjectCollectionBase.Returns an enumerator that iterates through the NameObjectCollectionBase.

(Унаследовано от NameObjectCollectionBase)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetKey(Int32)

Возвращает ключ (имя) файла cookie по указанному числовому индексу.Returns the key (name) of the cookie at the specified numerical index.

GetObjectData(SerializationInfo, StreamingContext)

Реализует интерфейс ISerializable и возвращает данные, необходимые для сериализации экземпляра NameObjectCollectionBase.Implements the ISerializable interface and returns the data needed to serialize the NameObjectCollectionBase instance.

(Унаследовано от NameObjectCollectionBase)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnDeserialization(Object)

Реализует интерфейс ISerializable и вызывает событие десериализации при завершении десериализации.Implements the ISerializable interface and raises the deserialization event when the deserialization is complete.

(Унаследовано от NameObjectCollectionBase)
Remove(String)

Удаляет из коллекции файл cookie с указанным именем.Removes the cookie with the specified name from the collection.

Set(HttpCookie)

Обновляет значение существующего файла cookie из коллекции файлов cookie.Updates the value of an existing cookie in a cookie collection.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Явные реализации интерфейса

ICollection.CopyTo(Array, Int32)

Копирует целый массив NameObjectCollectionBase в совместимый одномерный массив Array, начиная с заданного индекса целевого массива.Copies the entire NameObjectCollectionBase to a compatible one-dimensional Array, starting at the specified index of the target array.

(Унаследовано от NameObjectCollectionBase)
ICollection.IsSynchronized

Возвращает значение, указывающее на то, является ли доступ к объекту NameObjectCollectionBase синхронизированным (потокобезопасным).Gets a value indicating whether access to the NameObjectCollectionBase object is synchronized (thread safe).

(Унаследовано от NameObjectCollectionBase)
ICollection.SyncRoot

Возвращает объект, который позволяет синхронизировать доступ к объекту NameObjectCollectionBase.Gets an object that can be used to synchronize access to the NameObjectCollectionBase object.

(Унаследовано от NameObjectCollectionBase)

Методы расширения

Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

Применяется к

Дополнительно