Cookie Klas

Definitie

Biedt een set eigenschappen en methoden die worden gebruikt voor het beheren van cookies. Deze klasse kan niet worden overgenomen.

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
Overname
Cookie
Kenmerken

Voorbeelden

In het volgende voorbeeld wordt een aanvraag naar een URL verzonden en worden de cookies weergegeven die in het antwoord worden geretourneerd.

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
'

Opmerkingen

De Cookie klasse wordt gebruikt door een clienttoepassing om informatie op te halen over cookies die worden ontvangen met HTTP-antwoorden. De volgende cookie-indelingen worden ondersteund tijdens het parseren van de HTTP-antwoordheaders: de oorspronkelijke Netscape-specificatie, RFC 2109 en RFC 2965.

Zie de verschillende Cookie constructors voor een lijst met initiƫle eigenschapswaarden voor een exemplaar vanCookie.

Constructors

Name Description
Cookie()

Initialiseert een nieuw exemplaar van de Cookie klasse.

Cookie(String, String, String, String)

Initialiseert een nieuw exemplaar van de Cookie klasse met een opgegeven Name, Value, Pathen Domain.

Cookie(String, String, String)

Initialiseert een nieuw exemplaar van de Cookie klasse met een opgegeven Name, Valueen Path.

Cookie(String, String)

Initialiseert een nieuw exemplaar van de Cookie klasse met een opgegeven Name en Value.

Eigenschappen

Name Description
Comment

Hiermee haalt u een opmerking op die door de server kan worden toegevoegd aan een Cookie.

CommentUri

Hiermee haalt u een URI-opmerking op of stelt deze in die door de server kan worden geleverd Cookie.

Discard

Hiermee haalt u de verwijderingsvlag op die door de server is ingesteld of stelt u deze in.

Domain

Hiermee haalt u de URI op waarvoor de Cookie waarde geldig is of stelt u deze in.

Expired

Hiermee haalt u de huidige status van de Cookie.

Expires

Hiermee haalt u de vervaldatum en -tijd voor de Cookie als een DateTime.

HttpOnly

Bepaalt of een paginascript of andere actieve inhoud toegang heeft tot deze cookie.

Name

Hiermee haalt u de naam voor de Cookie.

Path

Hiermee haalt u de URI's op waarop de Cookie toepassing van toepassing is of stelt u deze in.

Port

Hiermee wordt een lijst met TCP-poorten ophaalt of ingesteld waarop de Cookie toepassing van toepassing is.

Secure

Hiermee haalt of stelt u het beveiligingsniveau van een Cookie.

TimeStamp

Hiermee krijgt u de tijd waarop de cookie is uitgegeven als een DateTime.

Value

Haalt of stelt de Value voor de Cookie.

Version

Hiermee wordt de versie van HTTP-statusonderhoud ophaalt of ingesteld waaraan de cookie voldoet.

Methoden

Name Description
Equals(Object)

Overschrijft de Equals(Object) methode.

GetHashCode()

Overschrijft de GetHashCode() methode.

GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ToString()

Overschrijft de ToString() methode.

Van toepassing op

Zie ook