HttpCookie Sınıf

  • Başvuru

Tanım

Ad Alanı:
System.Web
Bütünleştirilmiş Kod:
System.Web.dll

Tek tek HTTP tanımlama bilgilerini oluşturmak ve işlemek için tür açısından güvenli bir yol sağlar.

public ref class HttpCookie sealed
public sealed class HttpCookie
type HttpCookie = class
Public NotInheritable Class HttpCookie
Devralma
Object
HttpCookie

Örnekler

Aşağıdaki kod örneği, nesnesinde adlı DateCookieExample bir tanımlama bilgisinin nasıl denetleneceklerini HttpRequest gösterir. Tanımlama bilgisi bulunamazsa oluşturulur ve nesnesine HttpResponse eklenir. Tanımlama bilgisi 10 dakika içinde sona erecek şekilde ayarlanır.

<%@ 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>

Açıklamalar

sınıfı, HttpCookie tek tek tanımlama bilgilerinin özelliklerini alır ve ayarlar. HttpCookieCollection sınıfı, birden çok tanımlama bilgisini depolamak, almak ve yönetmek için yöntemler sağlar.

ASP.NET iki iç tanımlama bilgisi koleksiyonu içerir. nesnesinin Cookies koleksiyonu aracılığıyla erişilen koleksiyon HttpRequest , istemci tarafından üst bilgideki Cookie sunucuya iletilen tanımlama bilgilerini içerir. nesnesinin Cookies HttpResponse koleksiyonu aracılığıyla erişilen koleksiyon, sunucuda oluşturulan ve HTTP yanıt üst bilgisinde Set-Cookie istemciye iletilen yeni tanımlama bilgilerini içerir.

Oluşturucular

HttpCookie(String)

Yeni bir tanımlama bilgisi oluşturur ve adlandırabilirsiniz.
HttpCookie(String, String)

Yeni bir tanımlama bilgisine değer oluşturur, adlar ve atar.

Özellikler

Domain

Tanımlama bilgisinin ilişkilendirilecek etki alanını alır veya ayarlar.
Expires

Tanımlama bilgisinin son kullanma tarihini ve saatini alır veya ayarlar.
HasKeys

Tanımlama bilgisinin alt anahtarlara sahip olup olmadığını belirten bir değer alır.
HttpOnly

Tanımlama bilgisinin istemci tarafı betiği tarafından erişilebilir olup olmadığını belirten bir değeri alır veya ayarlar.
Item[String]

Özelliğin kısayolunu Values alır. Bu özellik, Active Server Pages'ın (ASP) önceki sürümleriyle uyumluluk için sağlanır.
Name

Tanımlama bilgisinin adını alır veya ayarlar.
Path

Geçerli tanımlama bilgisi ile iletecek sanal yolu alır veya ayarlar.
SameSite

Tanımlama bilgisinin SameSite özniteliğinin değerini alır veya ayarlar.
Secure

Tanımlama bilgisinin Güvenli Yuva Katmanı (SSL) kullanarak (yani yalnızca HTTPS üzerinden) iletilip aktarılmayacağını belirten bir değer alır veya ayarlar.
Shareable

Tanımlama bilgisinin çıktı önbelleğine katılmasına izin verilip verilmeyeceğini belirler.
Value

Tek bir tanımlama bilgisi değerini alır veya ayarlar.
Values

Tek bir tanımlama bilgisi nesnesi içinde yer alan anahtar/değer çiftleri koleksiyonunu alır.

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
TryParse(String, HttpCookie)

Bir tanımlama bilgisinin belirtilen dize gösterimini eşdeğerine HttpCookie dönüştürür ve dönüştürmenin başarılı olup olmadığını belirten bir değer döndürür.

Şunlara uygulanır

Ayrıca bkz.