HttpListenerResponse.SetCookie(Cookie) Método

Referência

Definição

Namespace:: System.Net

Assembly:: System.Net.HttpListener.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Origem:: HttpListenerResponse.cs

Origem:: HttpListenerResponse.cs

Origem:: HttpListenerResponse.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Adiciona ou atualiza um Cookie na coleção de cookies enviados com esta resposta.

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)

Parâmetros

cookie: Cookie

Um Cookie para esta resposta.

Exceções

ArgumentNullException

cookie é null.

ArgumentException

O cookie já existe na coleção e não foi possível substituí-lo.

Exemplos

O exemplo de código a seguir demonstra como chamar esse método.

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

Comentários

Dois cookies serão considerados os mesmos se os valores de suas Namepropriedades , Domaine Path forem iguais. Se essas três informações forem as mesmas, o método tentará atualizar o cookie. As comparações de nome e domínio não diferenciam maiúsculas de minúsculas, mas a comparação de caminho diferencia maiúsculas de minúsculas.

Aplica-se a

Partilhar via