Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.