Cookie.Version Właściwość

Definicja

Pobiera lub ustawia wersję konserwacji stanu HTTP, do której plik cookie jest zgodny.

public int Version { get; set; }

Wartość właściwości

Wersja konserwacji stanu HTTP, z którą jest zgodny plik cookie.

Wyjątki

Wartość określona dla wersji jest niedozwolona.

Przykłady

Poniższy przykład przedstawia właściwości plików cookie zwróconych w odpowiedzi. Pełny przykład można znaleźć w temacie Cookie klasy.

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

Uwagi

Wartość domyślna Version właściwości to 0 zgodna z oryginalną specyfikacją netscape. Jeśli wartość jest jawnie ustawiona na 1, musi być Cookie zgodna z dokumentem RFC 2109. Należy pamiętać, że jeśli obiekt Cookie został utworzony automatycznie, odbierając Set-Cookie2 nagłówka odpowiedzi HTTP, zgodność jest ustawiona na RFC 2965.

Próba ustawienia Version właściwości na wartość mniejszą niż zero spowoduje zgłoszenie wyjątku.

Dotyczy

Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Zobacz też