Cookie Třída

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.Primitives.dll

Zdroj:

Cookie.cs

Poskytuje sadu vlastností a metod, které se používají ke správě souborů cookie. Tato třída se nemůže dědit.

public ref class Cookie sealed

public sealed class Cookie

type Cookie = class

Public NotInheritable Class Cookie

Dědičnost

Object

Cookie

Příklady

Následující příklad odešle požadavek na adresu URL a zobrazí soubory cookie vrácené v odpovědi.

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
'

Poznámky

Třída Cookie je používána klientskou aplikací k načtení informací o souborech cookie přijatých pomocí odpovědí HTTP. Při analýze hlaviček odpovědi HTTP jsou podporovány následující formáty souborů cookie: původní specifikace Netscape, RFC 2109 a RFC 2965.

Seznam počátečních hodnot vlastností pro instanci Cookienaleznete v různých Cookie konstruktorech.

Konstruktory

Name	Description
Cookie()	Inicializuje novou instanci Cookie třídy.
Cookie(String, String, String, String)	Inicializuje novou instanci Cookie třídy se zadaným Name, Value, Patha Domain.
Cookie(String, String, String)	Inicializuje novou instanci Cookie třídy se zadaným Name, Valuea Path.
Cookie(String, String)	Inicializuje novou instanci Cookie třídy se zadaným Name a Value.

Vlastnosti

Name	Description
Comment	Získá nebo nastaví komentář, který server může přidat do Cookie.
CommentUri	Získá nebo nastaví komentář identifikátoru URI, který může server poskytnout Cookies .
Discard	Získá nebo nastaví příznak zahození nastavený serverem.
Domain	Získá nebo nastaví identifikátor URI, pro který Cookie je platný.
Expired	Získá nebo nastaví aktuální stav Cookie.
Expires	Získá nebo nastaví datum a čas vypršení platnosti pro Cookie jako DateTime.
HttpOnly	Určuje, zda má skript stránky nebo jiný aktivní obsah přístup k tomuto souboru cookie.
Name	Získá nebo nastaví název pro Cookie.
Path	Získá nebo nastaví identifikátory URI, na které se Cookie vztahuje.
Port	Získá nebo nastaví seznam portů TCP, na které Cookie se vztahuje.
Secure	Získá nebo nastaví úroveň Cookiezabezpečení .
TimeStamp	Získá čas, kdy byl soubor cookie vydán jako DateTime.
Value	Získá nebo nastaví Value pro Cookie.
Version	Získá nebo nastaví verzi údržby stavu HTTP, na kterou soubor cookie odpovídá.

Metody

Name	Description
Equals(Object)	Přepíše metodu Equals(Object) .
GetHashCode()	Přepíše metodu GetHashCode() .
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Přepíše metodu ToString() .

Viz také

• CookieCollection
• CookieContainer
• CookieException