HttpListenerResponse.SetCookie(Cookie) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přidá nebo aktualizuje Cookie soubor v kolekci souborů cookie odeslaných s touto odpovědí.
public:
void SetCookie(System::Net::Cookie ^ cookie);
public void SetCookie (System.Net.Cookie cookie);
member this.SetCookie : System.Net.Cookie -> unit
Public Sub SetCookie (cookie As Cookie)
Parametry
Výjimky
cookie
je null
.
Soubor cookie již v kolekci existuje a nelze ho nahradit.
Příklady
Následující příklad kódu ukazuje volání této metody.
// This example requires the System and System.Net namespaces.
public static void SimpleCookieExample(string[] prefixes)
{
// Create a listener.
HttpListener listener = new HttpListener();
// Add the prefixes.
foreach (string s in prefixes)
{
listener.Prefixes.Add(s);
}
listener.Start();
Console.WriteLine("Listening...");
// Note: The GetContext method blocks while waiting for a request.
HttpListenerContext context = listener.GetContext();
HttpListenerRequest request = context.Request;
// This application sends a cookie to the client marking the time
// they visited.
Cookie timeStampCookie = new Cookie("VisitDate", DateTime.Now.ToString());
// Obtain a response object.
HttpListenerResponse response = context.Response;
// Add the cookie to the response.
response.SetCookie(timeStampCookie);
// Construct a response.
string responseString = "<HTML><BODY> Hello world!</BODY></HTML>";
response.ContentEncoding = System.Text.Encoding.UTF8;
byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
// Send the response.
response.Close(buffer, true);
listener.Stop();
}
' This example requires the System and System.Net namespaces.
Public Shared Sub SimpleCookieExample(ByVal prefixes As String())
' Create a listener
Dim listener As HttpListener = New HttpListener()
' Add the prefixes
For Each s As String In prefixes
listener.Prefixes.Add(s)
Next
listener.Start()
Console.WriteLine("Listening...")
' Note: The GetContext method blocks while waiting for a request.
Dim context As HttpListenerContext = listener.GetContext()
Dim request As HttpListenerRequest = context.Request
' This application sends a cookie to the client marking the time
' they visited.
Dim timeStampCookie As Cookie = New Cookie("VisitDate", DateTime.Now.ToString())
' Obtain a response object.
Dim response As HttpListenerResponse = context.Response
' Add the cookie to the response.
response.SetCookie(timeStampCookie)
' Construct a response.
Dim responseString As String = "<HTML><BODY> Hello world!</BODY></HTML>"
response.ContentEncoding = System.Text.Encoding.UTF8
Dim buffer As Byte() = System.Text.Encoding.UTF8.GetBytes(responseString)
' Send the response.
response.Close(buffer, True)
listener.Stop()
End Sub
Poznámky
Dva soubory cookie se považují za stejné, pokud jsou hodnoty jejich Namevlastností , Domaina Path stejné. Pokud jsou tyto tři informace stejné, metoda se pokusí aktualizovat soubor cookie. Při porovnávání názvů a domén se nerozlišují malá a velká písmena, ale při porovnávání cest se rozlišují malá a malá písmena.