HttpListenerResponse.SetCookie(Cookie) Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Net

Assembly:: System.Net.HttpListener.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Origine:: HttpListenerResponse.cs

Origine:: HttpListenerResponse.cs

Origine:: HttpListenerResponse.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Aggiunge o aggiorna una classe Cookie nell'insieme di cookie inviati con questa risposta.

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)

Parametri

cookie: Cookie

Classe Cookie per questa risposta.

Eccezioni

ArgumentNullException

cookie è null.

ArgumentException

Il cookie esiste già nell'insieme e non può essere sostituito.

Esempio

Nell'esempio di codice seguente viene illustrata la chiamata a questo metodo.

// 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

Commenti

Due cookie vengono considerati uguali se i valori delle Namerelative proprietà , Domaine Path sono uguali. Se queste tre informazioni sono uguali, il metodo tenta di aggiornare il cookie. I confronti tra nomi e domini non fanno distinzione tra maiuscole e minuscole, ma il confronto tra percorsi fa distinzione tra maiuscole e minuscole.

Si applica a