Cookie.Version Propriedade

Definição

Espaço de Nomes:
System.Net
Assemblagens:
System.dll, System.Net.Primitives.dll
Assemblagem:
System.dll
Assemblagem:
System.Net.Primitives.dll
Assemblagem:
netstandard.dll

Obtém ou define a versão da manutenção de estado HTTP à qual o cookie se conforma.

public:
 property int Version { int get(); void set(int value); };
public int Version { get; set; }
member this.Version : int with get, set
Public Property Version As Integer

Valor de Propriedade

Int32

A versão da manutenção do estado HTTP à qual o cookie se conforma.

Exceções

ArgumentOutOfRangeException

O valor especificado para uma versão não é permitido.

Exemplos

O exemplo seguinte mostra as propriedades dos cookies devolvidos numa resposta. Para o exemplo completo, veja o tema da Cookie aula.

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

    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

Observações

O valor padrão da Version propriedade é 0, em conformidade com a especificação original do Netscape. Se o valor estiver explicitamente definido como 1, então isto Cookie deve estar em conformidade com a RFC 2109. Note que, se a Cookie foi criado automaticamente ao receber um cabeçalho de resposta HTTP Set-Cookie2, a conformidade é definida para RFC 2965.

Uma tentativa de definir a Version propriedade com um valor inferior a zero lançará uma exceção.

Aplica-se a

Ver também