HttpListenerResponse.Cookies 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得或設定隨回應所傳回之 Cookie 的集合。
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
屬性值
CookieCollection,包含回應所隨附的 Cookie。 如果沒有 Cookie 加入回應,則為空集合。
範例
下列程式代碼範例會檢查 Cookie 的要求,如果要求沒有,則會傳回具有回應的新 Cookie。
// 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
備註
Cookie 是儲存在本機 (用戶端) 電腦上的網頁伺服器的名稱/值文字數據。 支援下列 Cookie 格式:Netscape、 RFC 2109 和 RFC 2965。