• Article

Cookie Constructor (String, String, String, String)

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, path and domain.

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

Syntax

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

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

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.
  • domain
    Type: System.String
    The domain 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 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.