HttpListenerResponse.Cookies Vlastnost
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í.
Získá nebo nastaví kolekci souborů cookie vrácenou s odpovědí.
public:
property System::Net::CookieCollection ^ Cookies { System::Net::CookieCollection ^ get(); void set(System::Net::CookieCollection ^ value); };
public System.Net.CookieCollection Cookies { get; set; }
member this.Cookies : System.Net.CookieCollection with get, set
Public Property Cookies As CookieCollection
Hodnota vlastnosti
A CookieCollection , který obsahuje soubory cookie, které mají doprovodit odpověď. Kolekce je prázdná, pokud se do odpovědi nepřidají žádné soubory cookie.
Příklady
Následující příklad kódu zkontroluje požadavek na soubor cookie a vrátí nový soubor cookie s odpovědí, pokud požadavek neobsahuje.
// This example requires the System and System.Net namespaces.
public static string NextCustomerID()
{
// A real-world application would do something more robust
// to ensure uniqueness.
return DateTime.Now.ToString();
}
public static void SimpleListenerCookieExample(string[] prefixes)
{
// Create a listener.
HttpListener listener = new HttpListener();
// Add the prefixes.
foreach (string s in prefixes)
{
listener.Prefixes.Add(s);
}
listener.IgnoreWriteExceptions = true;
listener.Start();
Console.WriteLine("Listening...");
// Note: The GetContext method blocks while waiting for a request.
HttpListenerContext context = listener.GetContext();
HttpListenerRequest request = context.Request;
string customerID = null;
// Did the request come with a cookie?
Cookie cookie = request.Cookies["ID"];
if (cookie != null)
{
customerID=cookie.Value;
}
if (customerID !=null)
{
Console.WriteLine("Found the cookie!");
}
// Get the response object.
HttpListenerResponse response = context.Response;
// If they didn't provide a cookie containing their ID, give them one.
if (customerID == null)
{
customerID = NextCustomerID();
Cookie cook = new Cookie("ID", customerID );
response.AppendCookie (cook);
}
// Construct a response.
string responseString = "<HTML><BODY> Hello " + customerID + "!</BODY></HTML>";
byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
// Get the response stream and write the response to it.
response.ContentLength64 = buffer.Length;
System.IO.Stream output = response.OutputStream;
output.Write(buffer,0,buffer.Length);
// You must close the output stream.
output.Close();
// Closing the response sends the response to the client.
response.Close();
listener.Stop();
}
' This example requires the System and System.Net namespaces.
Public Shared Function NextCustomerID() As String
' A real-world application would do something more robust
' to ensure uniqueness.
Return DateTime.Now.ToString()
End Function
Public Shared Sub SimpleListenerCookieExample(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.IgnoreWriteExceptions = True
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
Dim customerID As String = Nothing
' Did the request come with a cookie?
Dim cookie As Cookie = request.Cookies("ID")
If cookie IsNot Nothing Then
customerID = cookie.Value
End If
If customerID IsNot Nothing Then
Console.WriteLine("Found the cookie!")
End If
' Get the response object.
Dim response As HttpListenerResponse = context.Response
' If they didn't provide a cookie containing their ID, give them one.
If customerID Is Nothing Then
customerID = NextCustomerID()
Dim cook As Cookie = New Cookie("ID", customerID)
response.AppendCookie(cook)
End If
' Construct a response.
Dim responseString As String = "<HTML><BODY> Hello " & customerID & "!</BODY></HTML>"
Dim buffer As Byte() = System.Text.Encoding.UTF8.GetBytes(responseString)
' Get the response stream and write the response to it.
response.ContentLength64 = buffer.Length
Dim output As System.IO.Stream = response.OutputStream
output.Write(buffer, 0, buffer.Length)
' You must close the output stream.
output.Close()
response.Close()
listener.Stop()
End Sub
Poznámky
Soubor cookie je textová data názvu/hodnoty z webového serveru, která jsou uložená v místním (klientském) počítači. Podporují se následující formáty souborů cookie: Netscape, RFC 2109 a RFC 2965.