Cookie 클래스

정의

네임스페이스:

System.Net

어셈블리:

netstandard.dll, System.Net.Primitives.dll

Source:

Cookie.cs

쿠키를 관리하는 데 사용되는 속성 및 메서드 집합을 제공합니다. 이 클래스는 상속할 수 없습니다.

public ref class Cookie sealed

public sealed class Cookie

type Cookie = class

Public NotInheritable Class Cookie

상속

Object

Cookie

예제

다음 예제에서는 URL에 요청을 보내고 응답에 반환된 쿠키를 표시합니다.

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
'

설명

이 Cookie 클래스는 클라이언트 애플리케이션에서 HTTP 응답으로 수신된 쿠키에 대한 정보를 검색하는 데 사용됩니다. HTTP 응답 헤더를 구문 분석하는 동안 지원되는 쿠키 형식은 원래 Netscape 사양, RFC 2109 및 RFC 2965입니다.

인스턴스 Cookie의 초기 속성 값 목록은 다양한 Cookie 생성자를 참조하세요.

생성자

Name	Description
Cookie()	Cookie 클래스의 새 인스턴스를 초기화합니다.
Cookie(String, String, String, String)	지정된 Cookie, Name, Value및 Path사용하여 Domain 클래스의 새 인스턴스를 초기화합니다.
Cookie(String, String, String)	지정된 Cookie, Name및 Value사용하여 Path 클래스의 새 인스턴스를 초기화합니다.
Cookie(String, String)	지정된 CookieName사용하여 Value 클래스의 새 인스턴스를 초기화합니다.

속성

Name	Description
Comment	서버에서 추가할 수 Cookie있는 주석을 가져오거나 설정합니다.
CommentUri	서버에서 제공할 Cookie수 있는 URI 주석을 가져오거나 설정합니다.
Discard	서버에서 설정한 무시 플래그를 가져오거나 설정합니다.
Domain	유효한 URI를 Cookie 가져오거나 설정합니다.
Expired	의 현재 상태를 Cookie가져오거나 설정합니다.
Expires	로의 만료 날짜 및 시간을 CookieDateTime가져오거나 설정합니다.
HttpOnly	페이지 스크립트 또는 다른 활성 콘텐츠가 이 쿠키에 액세스할 수 있는지 여부를 결정합니다.
Name	에 대한 Cookie이름을 가져오거나 설정합니다.
Path	적용되는 URI를 Cookie 가져오거나 설정합니다.
Port	적용되는 TCP 포트 Cookie 목록을 가져오거나 설정합니다.
Secure	의 보안 수준을 Cookie가져오거나 설정합니다.
TimeStamp	쿠키가 .로 DateTime발급된 시간을 가져옵니다.
Value	에 대한 Value값을 Cookie 가져오거나 설정합니다.
Version	쿠키가 준수하는 HTTP 상태 유지 관리의 버전을 가져오거나 설정합니다.

메서드

Name	Description
Equals(Object)	메서드를 재정의 Equals(Object) 합니다.
GetHashCode()	메서드를 재정의 GetHashCode() 합니다.
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	메서드를 재정의 ToString() 합니다.

추가 정보

• CookieCollection
• CookieContainer
• CookieException