HttpListenerResponse.Cookies HttpListenerResponse.Cookies HttpListenerResponse.Cookies HttpListenerResponse.Cookies Property

定義

取得或設定隨回應所傳回之 Cookie 的集合。Gets or sets the collection of cookies returned with the response.

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。A CookieCollection that contains cookies to accompany the response. 如果沒有 Cookie 加入回應,則為空集合。The collection is empty if no cookies have been added to the response.

範例

下列程式碼範例會檢查 cookie 的要求,並傳回新的 cookie 與回應,如果要求未訂用帳戶。The following code example checks a request for a cookie, and returns a new cookie with the response if the request did not have one.

// 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 伺服器的名稱/值的文字資料。A cookie is name/value text data from a Web server that is stored on the local (client) computer. 支援下列的 cookie 格式:Netscape、 RFC 2109,並RFC 2965The following cookie formats are supported: Netscape, RFC 2109, and RFC 2965.

適用於

另請參閱