Cookie Constructor (String, String, String) (System.Net)

Article
11/18/2011

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

Initializes a new instance of the Cookie class with the specified name, value and path.

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

Syntax

'Declaration
Public Sub New ( _
    name As String, _
    value As String, _
    path As String _
)

public Cookie(
    string name,
    string value,
    string path
)

Parameters

name
Type: System.String
The name of the Cookie. The name parameter cannot contain the following characters: equal sign (=), semicolon (;), comma (,), newline (\n), return (\r), tab (\t), and space character. The dollar sign character ($) cannot be the first character.

value
Type: System.String
The value for the Cookie. The value parameter cannot contain a semicolon (;) or a comma (,) unless they are contained in escaped double quotes.

path
Type: System.String
The path portion of a URI to which this cookie applies.

Exceptions

Exception	Condition
CookieException	name is nulla null reference (Nothing in Visual Basic) or an empty string (""). -or- name contains an unauthorized character. Using one of the following characters will cause an exception: equal sign (=) semicolon (;) comma (,) newline (\n) return (\r) tab (\t) space character dollar sign ($) as the first character -or- value is nulla null reference (Nothing in Visual Basic) or contains a semicolon (;) or a comma (,) that is not contained in escaped double quotes.

CookieException

name is nulla null reference (Nothing in Visual Basic) or an empty string ("").

-or-

name contains an unauthorized character. Using one of the following characters will cause an exception:

equal sign (=)
semicolon (;)
comma (,)
newline (\n)
return (\r)
tab (\t)
space character
dollar sign ($) as the first character

-or-

value is nulla null reference (Nothing in Visual Basic) or contains a semicolon (;) or a comma (,) that is not contained in escaped double quotes.

Remarks

The comma character is reserved for use as a delimiter to separate cookies on the same line. The following example shows how to use a comma inside a value parameter:

System.Net.Cookie cookie = new System.Net.Cookie("cookieID", "\"123,456\"");

The following illustration indicates the domain and path portion of a Uniform Resource Identifier (URI).

Domain and path portion of a URI

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.

Partager via