CookieCollection Class

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Represents a collection of Cookie objects.

Inheritance Hierarchy

System.Object
  System.Net.CookieCollection

Namespace:  System.Net
Assembly:  System.Net (in System.Net.dll)

Syntax

'Declaration
<DefaultMemberAttribute("Item")> _
Public NotInheritable Class CookieCollection _
    Implements ICollection, IEnumerable
[DefaultMemberAttribute("Item")]
public sealed class CookieCollection : ICollection, 
    IEnumerable

The CookieCollection type exposes the following members.

Constructors

  Name Description
Public methodSupported by Silverlight for Windows Phone CookieCollection Initializes a new instance of the CookieCollection class.

Top

Properties

  Name Description
Public propertySupported by Silverlight for Windows Phone Count Gets the number of cookies contained in the CookieCollection.
Public propertySupported by Silverlight for Windows Phone IsReadOnly Gets a value that indicates whether the CookieCollection is read-only.
Public propertySupported by Silverlight for Windows Phone IsSynchronized Gets a value that indicates whether access to the CookieCollection is thread safe.
Public propertySupported by Silverlight for Windows Phone Item Gets the cookie with the specified name from the collection.
Public propertySupported by Silverlight for Windows Phone SyncRoot Gets an object that you can use to synchronize access to the CookieCollection.

Top

Methods

  Name Description
Public methodSupported by Silverlight for Windows Phone Add(Cookie) Adds the specified Cookie to the collection.
Public methodSupported by Silverlight for Windows Phone Add(CookieCollection) Adds the contents of the specified CookieCollection to this collection.
Public methodSupported by Silverlight for Windows Phone CopyTo Copies the contents of this CookieCollection to the specified array, starting at the specified index.
Public methodSupported by Silverlight for Windows Phone Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows Phone Finalize Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone GetEnumerator Gets an enumerator to iterate through the CookieCollection.
Public methodSupported by Silverlight for Windows Phone GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone GetType Gets the Type of the current instance. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows Phone MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone ToString Returns a string that represents the current object. (Inherited from Object.)

Top

Extension Methods

  Name Description
Public Extension MethodSupported by Silverlight for Windows Phone AsQueryable Converts an IEnumerable to an IQueryable. (Defined by Queryable.)
Public Extension MethodSupported by Silverlight for Windows Phone Cast<TResult> Converts the elements of an IEnumerable to the specified type. (Defined by Enumerable.)
Public Extension MethodSupported by Silverlight for Windows Phone OfType<TResult> Filters the elements of an IEnumerable based on a specified type. (Defined by Enumerable.)

Top

Remarks

This class stores a collection of cookie objects associated with a client Web request.

You should always create a CookieCollection and add it to the request if you want to retrieve Cookie objects from the response.

Examples

The following example shows how to retrieve the CookieCollection from a response and write them to an isolated storage file.

' Get the response and write cookies to isolated storage. 
Private Sub ReadCallback(ByVal asynchronousResult As IAsyncResult)
    Dim request As HttpWebRequest = DirectCast(asynchronousResult.AsyncState,  _
        HttpWebRequest)
    Dim response As HttpWebResponse = _
    DirectCast(request.EndGetResponse(asynchronousResult), HttpWebResponse)
    Using isf As IsolatedStorageFile = IsolatedStorageFile.GetUserStoreForSite()
        Using isfs As IsolatedStorageFileStream = isf.OpenFile("CookieExCookies", _
            FileMode.OpenOrCreate, FileAccess.Write)
            Using sw As New StreamWriter(isfs)
                For Each cookieValue As Cookie In response.Cookies
                    sw.WriteLine("Cookie: " + cookieValue.ToString())
                Next
                sw.Close()
            End Using

        End Using
    End Using
End Sub
private void ReadCallback(IAsyncResult asynchronousResult)
{
    HttpWebRequest request = (HttpWebRequest)asynchronousResult.AsyncState;
    HttpWebResponse response = (HttpWebResponse)
        request.EndGetResponse(asynchronousResult);
    using (IsolatedStorageFile isf =
        IsolatedStorageFile.GetUserStoreForSite())
    {
        using (IsolatedStorageFileStream isfs = isf.OpenFile("CookieExCookies",
            FileMode.OpenOrCreate, FileAccess.Write))
        {
            using (StreamWriter sw = new StreamWriter(isfs))
            {
                foreach (Cookie cookieValue in response.Cookies)
                {
                    sw.WriteLine("Cookie: " + cookieValue.ToString());
                }
                sw.Close();
            }
        }

    }
}

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Other Resources