HttpCookie Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web

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

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

Aracılığıyla paylaş