Cookie Cookie Cookie Cookie Class

Definición

Proporciona un conjunto de propiedades y métodos que se usan para administrar las cookies.Provides a set of properties and methods that are used to manage cookies. Esta clase no puede heredarse.This class cannot be inherited.

public ref class Cookie sealed
[System.Serializable]
public sealed class Cookie
type Cookie = class
Public NotInheritable Class Cookie
Herencia
CookieCookieCookieCookie
Atributos

Ejemplos

En el ejemplo siguiente se envía una solicitud a una dirección URL y se muestran las cookies devueltas en la respuesta.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);
            }
            var request = (HttpWebRequest)WebRequest.Create(args[0]);
            request.CookieContainer = new CookieContainer();
        
            using (var response = (HttpWebResponse) request.GetResponse())
            {
                // Print the properties of each cookie.
                foreach (Cookie cook in response.Cookies)
                {
                    Console.WriteLine("Cookie:");
                    Console.WriteLine($"{cook.Name} = {cook.Value}");
                    Console.WriteLine($"Domain: {cook.Domain}");
                    Console.WriteLine($"Path: {cook.Path}");
                    Console.WriteLine($"Port: {cook.Port}");
                    Console.WriteLine($"Secure: {cook.Secure}");
                 
                    Console.WriteLine($"When issued: {cook.TimeStamp}");
                    Console.WriteLine($"Expires: {cook.Expires} (expired? {cook.Expired})");
                    Console.WriteLine($"Don't save: {cook.Discard}");
                    Console.WriteLine($"Comment: {cook.Comment}");
                    Console.WriteLine($"Uri for comments: {cook.CommentUri}");
                    Console.WriteLine($"Version: RFC {(cook.Version == 1 ? 2109 : 2965)}");
    
                    // Show the string representation of the cookie.
                    Console.WriteLine($"String: {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
*/

Imports System.Net

' 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 = WebRequest.Create(args(0))
    	request.CookieContainer = New CookieContainer()
    
    	Using response As HttpWebResponse = request.GetResponse()
    		' Print the properties of each cookie.
    		For Each cook As Cookie In response.Cookies
    			Console.WriteLine("Cookie:")
    			Console.WriteLine($"{cook.Name} = {cook.Value}")
    			Console.WriteLine($"Domain: {cook.Domain}")
    			Console.WriteLine($"Path: {cook.Path}")
    			Console.WriteLine($"Port: {cook.Port}")
    			Console.WriteLine($"Secure: {cook.Secure}")
    
    			Console.WriteLine($"When issued: {cook.TimeStamp}")
    			Console.WriteLine($"Expires: {cook.Expires} (expired? {cook.Expired})")
    			Console.WriteLine($"Don't save: {cook.Discard}")
    			Console.WriteLine($"Comment: {cook.Comment}")
    			Console.WriteLine($"Uri for comments: {cook.CommentUri}")
    			Console.WriteLine($"Version: RFC {If(cook.Version = 1, 2109, 2965)}")
    
    			' Show the string representation of the cookie.
    			Console.WriteLine($"String: {cook}")
    		Next
    	End Using
    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
'

Comentarios

Una Cookie aplicación cliente utiliza la clase para recuperar información acerca de las cookies que se reciben con respuestas http.The Cookie class is used by a client application to retrieve information about cookies that are received with HTTP responses. Durante el análisis de los encabezados de respuesta HTTP se admiten los siguientes formatos de cookie: la especificación de Netscape original, RFC 2109 y RFC 2965.The following cookie formats are supported during parsing of the HTTP response headers: the original Netscape specification, RFC 2109, and RFC 2965.

Para obtener una lista de los valores de propiedad iniciales de Cookieuna instancia de, Cookie vea los distintos constructores.For a list of initial property values for an instance of Cookie, see the various Cookie constructors.

Constructores

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

Inicializa una nueva instancia de la clase Cookie.Initializes a new instance of the Cookie class.

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

Inicializa una nueva instancia de la clase Cookie con los objetos Name y Value especificados.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)

Inicializa una nueva instancia de la clase Cookie con los objetos Name , Value y Path especificados.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)

Inicializa una nueva instancia de la clase Cookie con los objetos Name , Value , Path y Domain especificados.Initializes a new instance of the Cookie class with a specified Name, Value, Path, and Domain.

Propiedades

Comment Comment Comment Comment

Obtiene o establece un comentario que el servidor puede agregar a un objeto Cookie.Gets or sets a comment that the server can add to a Cookie.

CommentUri CommentUri CommentUri CommentUri

Obtiene o establece un URI que el servidor puede proporcionar con un objeto Cookie.Gets or sets a URI comment that the server can provide with a Cookie.

Discard Discard Discard Discard

Obtiene o establece el marcador de descarte establecido por el servidor.Gets or sets the discard flag set by the server.

Domain Domain Domain Domain

Obtiene o establece el URI para el cual es válido el objeto Cookie.Gets or sets the URI for which the Cookie is valid.

Expired Expired Expired Expired

Obtiene o establece el estado actual del objeto Cookie.Gets or sets the current state of the Cookie.

Expires Expires Expires Expires

Obtiene o establece la fecha y la hora de expiración para el objeto Cookie como DateTime.Gets or sets the expiration date and time for the Cookie as a DateTime.

HttpOnly HttpOnly HttpOnly HttpOnly

Determina si un script de página u otro contenido activo puede tener acceso a esta cookie.Determines whether a page script or other active content can access this cookie.

Name Name Name Name

Obtiene o establece el nombre para el objeto Cookie.Gets or sets the name for the Cookie.

Path Path Path Path

Obtiene o establece los identificadores URI a los que se aplica el objeto Cookie.Gets or sets the URIs to which the Cookie applies.

Port Port Port Port

Obtiene o establece una lista de puertos TCP a los que se aplica el objeto Cookie.Gets or sets a list of TCP ports that the Cookie applies to.

Secure Secure Secure Secure

Obtiene o establece el nivel de seguridad de un objeto Cookie.Gets or sets the security level of a Cookie.

TimeStamp TimeStamp TimeStamp TimeStamp

Obtiene la hora a la que se emitió la cookie en forma de DateTime.Gets the time when the cookie was issued as a DateTime.

Value Value Value Value

Obtiene o establece el objeto Value para Cookie.Gets or sets the Value for the Cookie.

Version Version Version Version

Obtiene o establece la versión de mantenimiento de estado HTTP a la que se ajusta la cookie.Gets or sets the version of HTTP state maintenance to which the cookie conforms.

Métodos

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

Reemplaza el método Equals(Object).Overrides the Equals(Object) method.

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

Reemplaza el método GetHashCode().Overrides the GetHashCode() method.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Reemplaza el método ToString().Overrides the ToString() method.

Se aplica a

Consulte también: