HttpListenerResponse.SetCookie(Cookie) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
隨這個回應傳送的 Cookie 集合中,加入或更新 Cookie。
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)
參數
例外狀況
cookie
為 null
。
Cookie 已經存在於集合中,無法取代。
範例
下列程式代碼範例示範如何呼叫這個方法。
// 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
備註
如果、 NameDomain和 Path 屬性的值相同,則會將兩個 Cookie 視為相同。 如果這三項資訊相同,此方法會嘗試更新 Cookie。 名稱和網域比較不區分大小寫,但路徑比較會區分大小寫。