Udostępnij za pośrednictwem


HttpCookie Klasa

Definicja

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

Zobacz też