HttpCookie HttpCookie HttpCookie HttpCookie Class

정의

개별 HTTP 쿠키를 만들고 조작할 수 있는 형식이 안전한 방법을 제공합니다.Provides a type-safe way to create and manipulate individual HTTP cookies.

public ref class HttpCookie sealed
public sealed class HttpCookie
type HttpCookie = class
Public NotInheritable Class HttpCookie
상속
HttpCookieHttpCookieHttpCookieHttpCookie

예제

다음 코드 예제에서는 명명 된 쿠키를 검사 하는 방법을 보여 줍니다 DateCookieExampleHttpRequest 개체입니다.The following code example demonstrates how to check for a cookie named DateCookieExample in the HttpRequest object. 쿠키 없는 경우이 생성 되어에 추가 된 HttpResponse 개체입니다.If the cookie is not found, it is created and added to the HttpResponse object. 쿠키는 10 분 후에 만료 되도록 설정 됩니다.The cookie is set to expire in 10 minutes.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Page_Load(object sender, EventArgs e)
    {
        StringBuilder sb = new StringBuilder();
        // Get cookie from the current request.
        HttpCookie cookie = Request.Cookies.Get("DateCookieExample");
        
        // Check if cookie exists in the current request.
        if (cookie == null)
        {
            sb.Append("Cookie was not received from the client. ");
            sb.Append("Creating cookie to add to the response. <br/>");
            // Create cookie.
            cookie = new HttpCookie("DateCookieExample");
            // Set value of cookie to current date time.
            cookie.Value = DateTime.Now.ToString();
            // Set cookie to expire in 10 minutes.
            cookie.Expires = DateTime.Now.AddMinutes(10d);
            // Insert the cookie in the current HttpResponse.
            Response.Cookies.Add(cookie);
        }
        else
        {
            sb.Append("Cookie retrieved from client. <br/>");
            sb.Append("Cookie Name: " + cookie.Name + "<br/>");
            sb.Append("Cookie Value: " + cookie.Value + "<br/>");
            sb.Append("Cookie Expiration Date: " + 
                cookie.Expires.ToString() + "<br/>");
        }
        Label1.Text = sb.ToString();
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpCookie Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1" runat="server"></asp:Label>
    </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
        Dim sb As New StringBuilder()
        ' Get cookie from current request.
        Dim cookie As HttpCookie
        cookie = Request.Cookies.Get("DateCookieExample")
        
        ' Check if cookie exists in the current request
        If (cookie Is Nothing) Then
            sb.Append("Cookie was not received from the client. ")
            sb.Append("Creating cookie to add to the response. <br/>")
            ' Create cookie.
            cookie = New HttpCookie("DateCookieExample")
            ' Set value of cookie to current date time.
            cookie.Value = DateTime.Now.ToString()
            ' Set cookie to expire in 10 minutes.
            cookie.Expires = DateTime.Now.AddMinutes(10D)
            ' Insert the cookie in the current HttpResponse.
            Response.Cookies.Add(cookie)
        Else
            sb.Append("Cookie retrieved from client. <br/>")
            sb.Append("Cookie Name: " + cookie.Name + "<br/>")
            sb.Append("Cookie Value: " + cookie.Value + "<br/>")
            sb.Append("Cookie Expiration Date: " & _
                cookie.Expires.ToString() & "<br/>")
        End If
        Label1.Text = sb.ToString()

    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpCookie Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1" runat="server"></asp:Label>    
    </div>
    </form>
</body>
</html>

설명

HttpCookie 클래스를 가져오고 개별 쿠키의 속성을 설정 합니다.The HttpCookie class gets and sets properties of individual cookies. HttpCookieCollection 클래스는 저장, 검색 및 여러 쿠키를 관리 하는 메서드를 제공 합니다.The HttpCookieCollection class provides methods to store, retrieve, and manage multiple cookies.

ASP.NET 두 내장 쿠키 컬렉션을 포함합니다.ASP.NET includes two intrinsic cookie collections. 통해 액세스할 수 있는 컬렉션을 Cookies 의 컬렉션을 HttpRequest 서버에 클라이언트에서 전송 하는 쿠키를 포함 하는 개체를 Cookie 헤더.The collection accessed through the Cookies collection of the HttpRequest object contains cookies transmitted by the client to the server in the Cookie header. 통해 액세스할 수 있는 컬렉션을 Cookies 의 컬렉션 합니다 HttpResponse 서버에서 생성 하 고 클라이언트에 전송 된 새 쿠키를 포함 하는 개체를 Set-Cookie HTTP 응답 헤더입니다.The collection accessed through the Cookies collection of the HttpResponse object contains new cookies created on the server and transmitted to the client in the Set-Cookie HTTP response header.

생성자

HttpCookie(String) HttpCookie(String) HttpCookie(String) HttpCookie(String)

새 쿠키를 만들고 이름을 지정합니다.Creates and names a new cookie.

HttpCookie(String, String) HttpCookie(String, String) HttpCookie(String, String) HttpCookie(String, String)

새 쿠키를 만들어 이름을 지정하고 값을 할당합니다.Creates, names, and assigns a value to a new cookie.

속성

Domain Domain Domain Domain

쿠키를 연결할 도메인을 가져오거나 설정합니다.Gets or sets the domain to associate the cookie with.

Expires Expires Expires Expires

쿠키의 만료 날짜 및 시간을 가져오거나 설정합니다.Gets or sets the expiration date and time for the cookie.

HasKeys HasKeys HasKeys HasKeys

쿠키에 하위 키가 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether a cookie has subkeys.

HttpOnly HttpOnly HttpOnly HttpOnly

클라이언트측 스크립트를 사용하여 쿠키에 액세스할 수 있는지 여부를 지정하는 값을 가져오거나 설정합니다.Gets or sets a value that specifies whether a cookie is accessible by client-side script.

Item[String] Item[String] Item[String] Item[String]

Values 속성에 대한 바로 가기를 가져옵니다.Gets a shortcut to the Values property. 이 속성은 이전 버전의 ASP(Active Server Pages)와의 호환성을 위해 제공됩니다.This property is provided for compatibility with previous versions of Active Server Pages (ASP).

Name Name Name Name

쿠키의 이름을 가져오거나 설정합니다.Gets or sets the name of a cookie.

Path Path Path Path

현재 쿠키와 함께 전송할 가상 경로를 가져오거나 설정합니다.Gets or sets the virtual path to transmit with the current cookie.

SameSite SameSite SameSite SameSite

쿠키의 SameSite 특성에 대한 값을 가져오거나 설정합니다.Gets or sets the value for the SameSite attribute of the cookie.

Secure Secure Secure Secure

SSL(Secure Sockets Layer)을 사용하여 쿠키를 전송할지, 즉 HTTPS로만 쿠키를 전송할지 여부를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether to transmit the cookie using Secure Sockets Layer (SSL)--that is, over HTTPS only.

Shareable Shareable Shareable Shareable

쿠키가 출력 캐시에 포함될 수 있는지 결정합니다.Determines whether the cookie is allowed to participate in output caching.

Value Value Value Value

개별 쿠키 값을 가져오거나 설정합니다.Gets or sets an individual cookie value.

Values Values Values Values

쿠키 개체 하나에 들어 있는 키/값 쌍의 컬렉션을 가져옵니다.Gets a collection of key/value pairs that are contained within a single cookie object.

메서드

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)
TryParse(String, HttpCookie) TryParse(String, HttpCookie) TryParse(String, HttpCookie) TryParse(String, HttpCookie)

쿠키에 대한 지정된 문자열 표현을 해당 HttpCookie 요소로 변환하고, 변환에 성공했는지를 나타내는 값을 반환합니다.Converts the specified string representation of a cookie into its HttpCookie equivalent and returns a value that indicates whether the conversion succeeded.

적용 대상

추가 정보