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 时返回包含响应的新 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 是存储在本地 (客户端) 计算机上的 Web 服务器的名称/值文本数据。 支持以下 Cookie 格式:Netscape、 RFC 2109 和 RFC 2965。