Cookie Cookie Cookie Cookie Class

Définition

Fournit un ensemble de propriétés et de méthodes qui permettent de gérer les cookies.Provides a set of properties and methods that are used to manage cookies. Cette classe ne peut pas être héritée.This class cannot be inherited.

public ref class Cookie sealed
[System.Serializable]
public sealed class Cookie
type Cookie = class
Public NotInheritable Class Cookie
Héritage
CookieCookieCookieCookie
Attributs

Exemples

L’exemple suivant envoie une demande à une URL et affiche les cookies retournés dans la réponse.The following example sends a request to a URL and displays the cookies returned in the response.

#using <System.dll>

using namespace System;
using namespace System::Net;

// This example is run at the command line.
// Specify one argument: the name of the host to 
// send the request to.
// If the request is sucessful, the example displays the contents of the cookies
// returned by the host.
int main()
{
   array<String^>^args = Environment::GetCommandLineArgs();
   if ( args == nullptr || args->Length != 2 )
   {
      Console::WriteLine( "Specify the URL to receive the request." );
      Environment::Exit( 1 );
   }

   
   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 );
      
   }

}

// Output from this example will be vary depending on the host name specified,
// but will be similar to the following.
/*
Cookie:
CustomerID = 13xyz
Domain: .contoso.com
Path: /
Port:
Secure: False
When issued: 1/14/2003 3:20:57 PM
Expires: 1/17/2013 11:14:07 AM (expired? False)
Don't save: False
Comment: 
Uri for comments:
Version: RFC 2965
String: CustomerID = 13xyz
*/
using System.Net;
using System;
namespace Examples.System.Net.Cookies
{
    // This example is run at the command line.
    // Specify one argument: the name of the host to 
    // send the request to.
    // If the request is sucessful, the example displays the contents of the cookies
    // returned by the host.
    
    public class CookieExample
    {   
        public static void Main(string[] args)
        {   
            if (args == null || args.Length != 1)
            {
                Console.WriteLine("Specify the URL to receive the request.");
                Environment.Exit(1);
            }
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create(args[0]);
            request.CookieContainer = new CookieContainer();
        
            HttpWebResponse response = (HttpWebResponse) request.GetResponse();
            
            

            // Print the properties of each cookie.
            foreach (Cookie cook in response.Cookies)
            {
                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 ? "2109" : "2965");

                // Show the string representation of the cookie.
                Console.WriteLine ("String: {0}", cook.ToString());
            }
        }
    }
}

// Output from this example will be vary depending on the host name specified,
// but will be similar to the following.
/*
Cookie:
CustomerID = 13xyz
Domain: .contoso.com
Path: /
Port:
Secure: False
When issued: 1/14/2003 3:20:57 PM
Expires: 1/17/2013 11:14:07 AM (expired? False)
Don't save: False
Comment: 
Uri for comments:
Version: RFC 2965
String: CustomerID = 13xyz
*/

Imports System.Net
Imports System

' This example is run at the command line.
' Specify one argument: the name of the host to 
' receive the request.
' If the request is sucessful, the example displays the contents of the cookies
' returned by the host.

Public Class CookieExample
    
    Public Shared Sub Main(args() As String)
        If args Is Nothing OrElse args.Length <> 1 Then
            Console.WriteLine("Specify the URL to receive the request.")
            Environment.Exit(1)
        End If
        Dim request As HttpWebRequest = CType(WebRequest.Create(args(0)), HttpWebRequest)
        request.CookieContainer = New CookieContainer()
        
        Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)

        
        
        ' Print the properties of each cookie.
        Dim cook As Cookie
        For Each cook In  response.Cookies
            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}", IIf(cook.Version = 1, "2109", "2965"))
            
            ' Show the string representation of the cookie.
            Console.WriteLine("String: {0}", cook.ToString())
        Next cook
    End Sub 'Main
End Class 'CookieExample 



' Output from this example will be vary depending on the host name specified,
' but will be similar to the following.
'
'Cookie:
'CustomerID = 13xyz
'Domain: .contoso.com
'Path: /
'Port:
'Secure: False
'When issued: 1/14/2003 3:20:57 PM
'Expires: 1/17/2013 11:14:07 AM (expired? False)
'Don't save: False
'Comment: 
'Uri for comments:
'Version: RFC 2965
'String: CustomerID = 13xyz
'

Remarques

Le Cookie classe est utilisée par une application cliente pour récupérer des informations sur les cookies qui sont reçus avec des réponses HTTP.The Cookie class is used by a client application to retrieve information about cookies that are received with HTTP responses. Les formats de cookie suivants sont pris en charge lors de l’analyse des en-têtes de réponse HTTP : la spécification, la norme RFC 2109 et RFC 2965 Netscape d’origine.The following cookie formats are supported during parsing of the HTTP response headers: the original Netscape specification, RFC 2109, and RFC 2965.

Pour obtenir la liste des valeurs initiales des propriétés d’une instance de Cookie, consultez les divers Cookie constructeurs.For a list of initial property values for an instance of Cookie, see the various Cookie constructors.

Constructeurs

Cookie() Cookie() Cookie() Cookie()

Initialise une nouvelle instance de la classe Cookie.Initializes a new instance of the Cookie class.

Cookie(String, String) Cookie(String, String) Cookie(String, String) Cookie(String, String)

Initialise une nouvelle instance de la classe Cookie avec les Name et Value spécifiés.Initializes a new instance of the Cookie class with a specified Name and Value.

Cookie(String, String, String) Cookie(String, String, String) Cookie(String, String, String) Cookie(String, String, String)

Initialise une nouvelle instance de la classe Cookie avec les Name, Value et Path spécifiés.Initializes a new instance of the Cookie class with a specified Name, Value, and Path.

Cookie(String, String, String, String) Cookie(String, String, String, String) Cookie(String, String, String, String) Cookie(String, String, String, String)

Initialise une nouvelle instance de la classe Cookie avec les Name, Value, Path et Domain spécifiés.Initializes a new instance of the Cookie class with a specified Name, Value, Path, and Domain.

Propriétés

Comment Comment Comment Comment

Obtient ou définit un commentaire que le serveur peut ajouter à Cookie.Gets or sets a comment that the server can add to a Cookie.

CommentUri CommentUri CommentUri CommentUri

Obtient ou définit un commentaire URI que le serveur peut fournir avec un Cookie.Gets or sets a URI comment that the server can provide with a Cookie.

Discard Discard Discard Discard

Obtient ou définit l'indicateur de suppression défini par le serveur.Gets or sets the discard flag set by the server.

Domain Domain Domain Domain

Obtient ou définit l'URI pour lequel Cookie est valide.Gets or sets the URI for which the Cookie is valid.

Expired Expired Expired Expired

Obtient ou définit l'état actuel de Cookie.Gets or sets the current state of the Cookie.

Expires Expires Expires Expires

Obtient ou définit la date et l'heure d'expiration de Cookie sous la forme DateTime.Gets or sets the expiration date and time for the Cookie as a DateTime.

HttpOnly HttpOnly HttpOnly HttpOnly

Détermine si un script de page ou un autre contenu actif peut accéder à ce cookie.Determines whether a page script or other active content can access this cookie.

Name Name Name Name

Obtient ou définit le nom de Cookie.Gets or sets the name for the Cookie.

Path Path Path Path

Obtient ou définit les URI auxquels Cookie s'applique.Gets or sets the URIs to which the Cookie applies.

Port Port Port Port

Obtient ou définit la liste de ports TCP auxquels Cookie s'applique.Gets or sets a list of TCP ports that the Cookie applies to.

Secure Secure Secure Secure

Obtient ou définit le niveau de sécurité d'un Cookie.Gets or sets the security level of a Cookie.

TimeStamp TimeStamp TimeStamp TimeStamp

Obtient sous la forme DateTime l'heure d'émission du cookie.Gets the time when the cookie was issued as a DateTime.

Value Value Value Value

Obtient ou définit Value pour Cookie.Gets or sets the Value for the Cookie.

Version Version Version Version

Obtient ou définit la version de la maintenance d'état HTTP à laquelle le cookie se conforme.Gets or sets the version of HTTP state maintenance to which the cookie conforms.

Méthodes

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Substitue la méthode Equals(Object).Overrides the Equals(Object) method.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Substitue la méthode GetHashCode().Overrides the GetHashCode() method.

GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Substitue la méthode ToString().Overrides the ToString() method.

S’applique à

Voir aussi