HttpCookie Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapewnia bezpieczny typ sposób tworzenia i manipulowania poszczególnymi plikami cookie HTTP.

public ref class HttpCookie sealed

public sealed class HttpCookie

type HttpCookie = class

Public NotInheritable Class HttpCookie

Dziedziczenie: Object
HttpCookie

Przykłady

Poniższy przykład kodu pokazuje, jak sprawdzić plik cookie o nazwie DateCookieExample w HttpRequest obiekcie. Jeśli plik cookie nie zostanie znaleziony, zostanie utworzony i dodany do HttpResponse obiektu. Plik cookie zostanie ustawiony na wygaśnięcie w ciągu 10 minut.

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

Uwagi

Klasa HttpCookie pobiera i ustawia właściwości poszczególnych plików cookie. Klasa HttpCookieCollection udostępnia metody przechowywania, pobierania i zarządzania wieloma plikami cookie.

ASP.NET zawiera dwie wewnętrzne kolekcje plików cookie. Kolekcja dostępna za pośrednictwem Cookies kolekcji HttpRequest obiektu zawiera pliki cookie przesyłane przez klienta do serwera w nagłówku Cookie . Kolekcja dostępna za pośrednictwem Cookies kolekcji HttpResponse obiektu zawiera nowe pliki cookie utworzone na serwerze i przesyłane do klienta w nagłówku Set-Cookie odpowiedzi HTTP.

Konstruktory

HttpCookie(String)	Tworzy i nazywa nowy plik cookie.
HttpCookie(String, String)	Tworzy, nazwy i przypisuje wartość do nowego pliku cookie.

Właściwości

Domain	Pobiera lub ustawia domenę w celu skojarzenia pliku cookie z.
Expires	Pobiera lub ustawia datę i godzinę wygaśnięcia pliku cookie.
HasKeys	Pobiera wartość wskazującą, czy plik cookie ma podklucze.
HttpOnly	Pobiera lub ustawia wartość określającą, czy plik cookie jest dostępny dla skryptu po stronie klienta.
Item[String]	Pobiera skrót do Values właściwości. Ta właściwość jest zapewniana pod kątem zgodności z poprzednimi wersjami usług Active Server Pages (ASP).
Name	Pobiera lub ustawia nazwę pliku cookie.
Path	Pobiera lub ustawia ścieżkę wirtualną do przesyłania za pomocą bieżącego pliku cookie.
SameSite	Pobiera lub ustawia wartość atrybutu SameSite pliku cookie.
Secure	Pobiera lub ustawia wartość wskazującą, czy plik cookie ma być przesyłany przy użyciu protokołu Secure Sockets Layer (SSL) — czyli tylko za pośrednictwem protokołu HTTPS.
Shareable	Określa, czy plik cookie może uczestniczyć w buforowaniu danych wyjściowych.
Value	Pobiera lub ustawia pojedynczą wartość pliku cookie.
Values	Pobiera kolekcję par klucz/wartość, które znajdują się w jednym obiekcie pliku cookie.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TryParse(String, HttpCookie)	Konwertuje określoną reprezentację ciągu pliku cookie na HttpCookie odpowiednik i zwraca wartość wskazującą, czy konwersja zakończyła się pomyślnie.

Dotyczy