HttpListenerResponse.SetCookie(Cookie) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет или обновляет файл cookie Cookie в коллекции файлов cookie, отправленной вместе с этим ответом.
public:
void SetCookie(System::Net::Cookie ^ cookie);public void SetCookie (System.Net.Cookie cookie);member this.SetCookie : System.Net.Cookie -> unitPublic 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
Комментарии
Два файла cookie считаются одинаковыми, если значения их Nameсвойств , Domainи Path совпадают. Если эти три элемента информации совпадают, метод пытается обновить файл cookie. При сравнении имен и доменов регистр не учитывается, но при сравнении путей учитывается регистр.
