Cookie Clase

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.dll

Proporciona un conjunto de propiedades y métodos que se usan para administrar cookies. Esta clase no puede heredarse.

public ref class Cookie sealed

[System.Serializable]
public sealed class Cookie

[<System.Serializable>]
type Cookie = class

Public NotInheritable Class Cookie

Herencia

Object

Cookie

Atributos

SerializableAttribute

Ejemplos

En el ejemplo siguiente se envía una solicitud a una dirección URL y se muestran las cookies devueltas en la respuesta.

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
End Class



' 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 aplicación cliente usa la Cookie clase para recuperar información sobre las cookies que se reciben con respuestas HTTP. Los siguientes formatos de cookies se admiten durante el análisis de los encabezados de respuesta HTTP: la especificación original de Netscape, RFC 2109 y RFC 2965.

Para obtener una lista de valores de propiedad iniciales para una instancia de Cookie, vea los distintos Cookie constructores.

Constructores

Nombre	Description
Cookie()	Inicializa una nueva instancia de la clase Cookie.
Cookie(String, String, String, String)	Inicializa una nueva instancia de la Cookie clase con un especificado Name, Value, Pathy Domain.
Cookie(String, String, String)	Inicializa una nueva instancia de la Cookie clase con un especificado Name, Valuey Path.
Cookie(String, String)	Inicializa una nueva instancia de la Cookie clase con un especificado Name y Value.

Propiedades

Nombre	Description
Comment	Obtiene o establece un comentario que el servidor puede agregar a .Cookie
CommentUri	Obtiene o establece un comentario de URI que el servidor puede proporcionar con .Cookie
Discard	Obtiene o establece la marca de descarte establecida por el servidor.
Domain	Obtiene o establece el URI para el Cookie que es válido.
Expired	Obtiene o establece el estado actual de .Cookie
Expires	Obtiene o establece la fecha y hora de expiración de Cookie como .DateTime
HttpOnly	Determina si un script de página u otro contenido activo puede acceder a esta cookie.
Name	Obtiene o establece el nombre de .Cookie
Path	Obtiene o establece los URI a los que se aplica .Cookie
Port	Obtiene o establece una lista de puertos TCP a los Cookie que se aplica .
Secure	Obtiene o establece el nivel de seguridad de .Cookie
TimeStamp	Obtiene la hora en que se emitió la cookie como .DateTime
Value	Obtiene o establece el objeto Value para .Cookie
Version	Obtiene o establece la versión de mantenimiento de estado HTTP a la que se ajusta la cookie.

Métodos

Nombre	Description
Equals(Object)	Invalida el Equals(Object) método .
GetHashCode()	Invalida el GetHashCode() método .
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ToString()	Invalida el ToString() método .

Consulte también

• CookieCollection
• CookieContainer
• CookieException