System [00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00] 1.0.3300.0 1.0.5000.0 2.0.0.0 4.0.0.0 Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details. System.Object

The class is used by a client application to retrieve information about cookies that are received with HTTP responses. The following cookie formats are supported during parsing of the HTTP response headers: the original Netscape specification, RFC 2109, and RFC 2965.

For a list of initial property values for an instance of , see the various constructors.

Provides a set of properties and methods that are used to manage cookies. This class cannot be inherited.

- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0

  The default constructor initializes all fields to their default values, using empty strings ("") for , , , and . Note that at least the property must be initialized before using an instance of the class.

  Initializes a new instance of the class.

- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0

  The default for the parameter uses the empty string ("").

  The parameter for a must not be a null reference (Nothing in Visual Basic). The following characters are reserved and cannot be passed in the parameter unless the string passed in the parameter is enclosed in double quotes: semicolon, comma. So the following example constructor would succeed but when you try to add this to a instance with the or methods the operation will fail and throw an exception:

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

  However, the following constructor with these special characters escaped will create a that can be added to a instance:

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

  The comma character is used as a delimiter between separate cookies on the same line.

  Initializes a new instance of the class with a specified and .

  The name of a . The following characters must not be used inside : equal sign, semicolon, comma, newline (\n), return (\r), tab (\t), and space character. The dollar sign character ("$") cannot be the first character.
  The value of a . The following characters must not be used inside : semicolon, comma.
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0

  The default for the parameter uses the empty string ("").

  The parameter for a must not be a null reference (Nothing in Visual Basic). The following characters are reserved and can not cannot be passed in the parameter unless the string passed in the parameter is enclosed in double quotes: semicolon, comma. So the following example constructor would succeed but when you try to add this to a instance with the or methods the operation will fail and throw an exception:

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

  However, the following constructor with these special characters escaped will create a that can be added to a instance:

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

  The comma character is used as a delimiter between separate cookies on the same line.

  Initializes a new instance of the class with a specified , , and .

  The name of a . The following characters must not be used inside : equal sign, semicolon, comma, newline (\n), return (\r), tab (\t), and space character. The dollar sign character ("$") cannot be the first character.
  The value of a . The following characters must not be used inside : semicolon, comma.
  The subset of URIs on the origin server to which this applies. The default value is "/".
- Constructor
  1.0.5000.0
  2.0.0.0
  4.0.0.0

  The default for the and parameters uses the empty string ("").

  The parameter for a must not be a null reference (Nothing in Visual Basic). The following characters are reserved and cannot be passed in the parameter unless the string passed in the parameter is enclosed in double quotes: semicolon, comma. So the following example constructor would succeed but when you try to add this to a instance with the or methods the operation will fail and throw an exception:

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

  However, the following constructor with these special characters escaped will create a that can be added to a instance:

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

  The comma character is used as a delimiter between separate cookies on the same line.

  Initializes a new instance of the class with a specified , , , and .

  The name of a . The following characters must not be used inside : equal sign, semicolon, comma, newline (\n), return (\r), tab (\t), and space character. The dollar sign character ("$") cannot be the first character.
  The value of a object. The following characters must not be used inside : semicolon, comma.
  The subset of URIs on the origin server to which this applies. The default value is "/".
  The optional internet domain for which this is valid. The default value is the host this has been received from.
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String To be added: an object of type 'string'

  The client can inspect this optional comment for information added by the server. For example, the server could include information about issues like the privacy policy or intended usage.

  Gets or sets a comment that the server can add to a .

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Uri To be added: an object of type 'Uri'

  The URI can provide optional information, such as how the server uses the .

  Gets or sets a URI comment that the server can provide with a .

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean To be added: an object of type 'bool'

  When true, this property instructs the client application not to save the on the user's hard disk when a session ends.

  Gets or sets the discard flag set by the server.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String To be added: an object of type 'string'

  A server cannot indicate a domain other than its own URI. However, it can indicate more than one server in the domain. The default value is the host that this cookie has been received from.

  Gets or sets the URI for which the is valid.

- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean `` To be added

  Overrides the method.

  Returns true if the is equal to . Two instances are equal if their , , , , and properties are equal. and string comparisons are case-insensitive.

  A reference to a .
- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean To be added: an object of type 'bool'

  Expired cookies, if received, should be destroyed by the client application.

  Gets or sets the current state of the .

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.DateTime To be added: an object of type 'DateTime'

  Setting the property to makes this a session , which is its default value.

  The property of is used to determine if the is set in or . If the property is set to , then is assumed.

  Gets or sets the expiration date and time for the as a .

- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Int32

  Classes that might be used as a key in a hash table must provide this override, because objects that are used as keys in a hash table are required to generate their own hash code through this method.

  Overrides the method.

  The 32-bit signed integer hash code for this instance.

- Property
  2.0.0.0
  4.0.0.0
  System.Boolean To be added.

  When this property is set to true, a page script or other active content cannot access this cookie.

  Determines whether a page script or other active content can access this cookie.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String To be added: an object of type 'string'

  The property must be initialized before using an instance of the class.

  The following characters are reserved and cannot be used for this attribute value: equal sign, semicolon, comma, new line (\n), return (\r), tab (\t), and space character. The dollar sign ($) character cannot be the first character.

  Gets or sets the name for the .

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String To be added: an object of type 'string'

  The property specifies the subset of URIs on the origin server to which this applies. If this propery is not specified, then this will be sent to all pages on the origin server or servers.

  Gets or sets the URIs to which the applies.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String To be added: an object of type 'string'

  This attribute restricts the ports to which this may be sent. The default value means no restriction. Setting this to the empty string ("") will restrict the port to the one used in the HTTP response. Otherwise, the value must be a double-quoted string that contains port values delimited with commas.

  Gets or sets a list of TCP ports that the applies to.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Boolean To be added: an object of type 'bool'

  In effect, when this property is true this cookie may be sent only with https:// requests.

  Gets or sets the security level of a .

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.DateTime To be added: an object of type 'DateTime'

  This is a read-only property.

  Gets the time when the cookie was issued as a .

- Method
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String

  The exact format of the string depends on the RFC that this cookie conforms to.

  Overrides the method.

  Returns a string representation of this object that is suitable for including in a HTTP Cookie: request header.

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.String To be added: an object of type 'string'

  The of a must not be null. The following characters are reserved and cannot be used for this property: semicolon, comma.

  Gets or sets the for the .

- Property
  1.0.5000.0
  2.0.0.0
  4.0.0.0
  System.Int32 To be added: an object of type 'int'

  The default value for the property is 0, complying with the original Netscape specification. If the value is explicitly set to 1, then this must conform to RFC 2109. Note that if a was created automatically by receiving a Set-Cookie2 HTTP response header, the conformance is set to RFC 2965.

  An attempt to set the property to a value less than zero will throw an exception.

  Gets or sets the version of HTTP state maintenance to which the cookie conforms.