Cookie Klass

Definition

Innehåller en uppsättning egenskaper och metoder som används för att hantera cookies. Det går inte att ärva den här klassen.

public ref class Cookie sealed
public sealed class Cookie
[System.Serializable]
public sealed class Cookie
type Cookie = class
[<System.Serializable>]
type Cookie = class
Public NotInheritable Class Cookie
Arv
Cookie
Attribut

Exempel

I följande exempel skickas en begäran till en URL och de cookies som returneras i svaret visas.

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
'

Kommentarer

Klassen Cookie används av ett klientprogram för att hämta information om cookies som tas emot med HTTP-svar. Följande cookieformat stöds vid parsning av HTTP-svarshuvuden: den ursprungliga Netscape-specifikationen, RFC 2109 och RFC 2965.

En lista över inledande egenskapsvärden för en instans av Cookiefinns i de olika Cookie konstruktorerna.

Konstruktorer

Name Description
Cookie()

Initierar en ny instans av Cookie klassen.

Cookie(String, String, String, String)

Initierar en ny instans av Cookie klassen med en angiven Name, Value, Pathoch Domain.

Cookie(String, String, String)

Initierar en ny instans av Cookie klassen med en angiven Name, Valueoch Path.

Cookie(String, String)

Initierar en ny instans av Cookie klassen med angivet Name och Value.

Egenskaper

Name Description
Comment

Hämtar eller anger en kommentar som servern kan lägga till i en Cookie.

CommentUri

Hämtar eller anger en URI-kommentar som servern kan ge med en Cookie.

Discard

Hämtar eller anger den ignorerande flagga som angetts av servern.

Domain

Hämtar eller anger den URI som Cookie är giltig för.

Expired

Hämtar eller anger aktuellt tillstånd för Cookie.

Expires

Hämtar eller anger förfallodatum och tid för Cookie som .DateTime

HttpOnly

Avgör om ett sidskript eller annat aktivt innehåll kan komma åt den här cookien.

Name

Hämtar eller anger namnet på Cookie.

Path

Hämtar eller anger de URI:er som Cookie gäller.

Port

Hämtar eller anger en lista över TCP-portar som Cookie gäller för.

Secure

Hämtar eller anger säkerhetsnivån för en Cookie.

TimeStamp

Hämtar den tid då cookien utfärdades som en DateTime.

Value

Hämtar eller anger Value för Cookie.

Version

Hämtar eller anger den version av HTTP-tillståndsunderhåll som cookien överensstämmer med.

Metoder

Name Description
Equals(Object)

Åsidosätter Equals(Object) metoden.

GetHashCode()

Åsidosätter GetHashCode() metoden.

GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Åsidosätter ToString() metoden.

Gäller för

Se även