Cookie::Name Property
Gets or sets the name for the Cookie.
Assembly: System (in System.dll)
| Exception | Condition |
|---|---|
| CookieException | The value specified for a set operation is null or the empty string - or - The value specified for a set operation contained an illegal character. The following characters must not be used inside the Name property: equal sign, semicolon, comma, newline (\n), return (\r), tab (\t), and space character. The dollar sign character ("$") cannot be the first character. |
The Name property must be initialized before using an instance of the Cookie 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.
The following example displays the properties of cookies returned in a response. For the complete example, see the Cookie class topic.
HttpWebRequest^ request = dynamic_cast<HttpWebRequest^>(WebRequest::Create( args[ 1 ] )); request->CookieContainer = gcnew CookieContainer; HttpWebResponse^ response = dynamic_cast<HttpWebResponse^>(request->GetResponse()); response->Cookies = request->CookieContainer->GetCookies( request->RequestUri ); // Print the properties of each cookie. System::Collections::IEnumerator^ myEnum = response->Cookies->GetEnumerator(); while ( myEnum->MoveNext() ) { Cookie^ cook = safe_cast<Cookie^>(myEnum->Current); Console::WriteLine( "Cookie:" ); Console::WriteLine( "{0} = {1}", cook->Name, cook->Value ); Console::WriteLine( "Domain: {0}", cook->Domain ); Console::WriteLine( "Path: {0}", cook->Path ); Console::WriteLine( "Port: {0}", cook->Port ); Console::WriteLine( "Secure: {0}", cook->Secure ); Console::WriteLine( "When issued: {0}", cook->TimeStamp ); Console::WriteLine( "Expires: {0} (expired? {1})", cook->Expires, cook->Expired ); Console::WriteLine( "Don't save: {0}", cook->Discard ); Console::WriteLine( "Comment: {0}", cook->Comment ); Console::WriteLine( "Uri for comments: {0}", cook->CommentUri ); Console::WriteLine( "Version: RFC {0}", cook->Version == 1 ? (String^)"2109" : "2965" ); // Show the string representation of the cookie. Console::WriteLine( "String: {0}", cook ); }
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 3.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1