Compartir a través de

HttpWebClientProtocol.CookieContainer Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.Services.Protocols
Ensamblado:
System.Web.Services.dll

Obtiene o establece la colección de cookies.

public:
 property System::Net::CookieContainer ^ CookieContainer { System::Net::CookieContainer ^ get(); void set(System::Net::CookieContainer ^ value); };
public System.Net.CookieContainer CookieContainer { get; set; }
member this.CookieContainer : System.Net.CookieContainer with get, set
Public Property CookieContainer As CookieContainer

Valor de propiedad

CookieContainer

CookieContainer que representa las cookies de un cliente de servicios Web.

Ejemplos

El ejemplo de código siguiente es un cliente Web Forms de un servicio web XML que usa el estado de sesión. El cliente almacena la cookie HTTP que identifica de forma única la sesión almacenándola en el estado de sesión del cliente.

<%@ Page Language="C#" %>
<%@ Import Namespace="System.IO" %>
<%@ Import Namespace="System.Net" %>

<html>

    <script runat="server">

        void EnterBtn_Click(Object Src, EventArgs E) 
    {
      // Create a new instance of a proxy class for your XML Web service.
      ServerUsage su = new ServerUsage();
          CookieContainer cookieJar;

      // Check to see if the cookies have already been saved for this session.
      if (Session["CookieJar"] == null) 
        cookieJar= new CookieContainer();
          else
       cookieJar = (CookieContainer) Session["CookieJar"];

        // Assign the CookieContainer to the proxy class.
        su.CookieContainer = cookieJar;

      // Invoke an XML Web service method that uses session state and thus cookies.
      int count = su.PerSessionServiceUsage();         

      // Store the cookies received in the session state for future retrieval by this session.
      Session["CookieJar"] = cookieJar;

          // Populate the text box with the results from the call to the XML Web service method.
          SessionCount.Text = count.ToString();  
        }
         
    </script>
    <body>
       <form runat=server ID="Form1">
           
             Click to bump up the Session Counter.
             <p>
             <asp:button text="Bump Up Counter" Onclick="EnterBtn_Click" runat=server ID="Button1" NAME="Button1"/>
             <p>
             <asp:label id="SessionCount"  runat=server/>
          
       </form>
    </body>
</html>

<%@ Page Language="VB" %>
<%@ Import Namespace="System.IO" %>
<%@ Import Namespace="System.Net" %>

<html>

    <script runat=server>

        Public Sub EnterBtn_Click(src As Object, E As EventArgs) 

      ' Create a new instance of a proxy class for your XML Web service.
      Dim su As ServerUsage = new ServerUsage()
          Dim cookieJar As CookieContainer

      ' Check to see if the cookies have already been saved for this session.
      If (Session("CookieJar") Is Nothing) 
        cookieJar= new CookieContainer()
          Else
       cookieJar = Session("CookieJar")
      End If
   

        ' Assign the CookieContainer to the proxy class.
        su.CookieContainer = cookieJar

      ' Invoke an XML Web service method that uses session state and thus cookies.
      Dim count As Integer = su.PerSessionServiceUsage()         

      ' Store the cookies received in the session state for future retrieval by this session.
      Session("CookieJar") = cookieJar

          ' Populate the text box with the results from the call to the XML Web service method.
          SessionCount.Text = count.ToString()  
    End Sub
         
    </script>
    <body>
       <form runat=server ID="Form1">
           
             Click to bump up the Session Counter.
             <p>
             <asp:button text="Bump Up Counter" Onclick="EnterBtn_Click" runat=server ID="Button1" NAME="Button1"/>
             <p>
             <asp:label id="SessionCount"  runat=server/>
          
       </form>
    </body>
</html>

Comentarios

Si un método de servicio web XML usa el estado de sesión, se devuelve una cookie en los encabezados de respuesta al cliente del servicio web XML que identifica de forma única la sesión de ese cliente de servicio web XML. Para que un servicio web XML mantenga el estado de sesión de un cliente, el cliente debe almacenar la cookie. Los clientes reciben la cookie HTTP mediante la creación de una nueva instancia de CookieContainer y la asignación a la CookieContainer propiedad de la clase proxy antes de llamar al método de servicio web XML. Si necesita mantener el estado de sesión más allá de cuándo la instancia de clase de proxy sale del ámbito, el cliente debe almacenar la cookie HTTP entre llamadas al servicio web XML. Por ejemplo, un cliente Web Forms puede almacenar la cookie HTTP guardando en CookieContainer su propio estado de sesión. Dado que no todos los servicios web XML usan el estado de sesión y, por tanto, los clientes no siempre deben usar la CookieContainer propiedad de un proxy de cliente, la documentación del servicio web XML debe indicar si se usa el estado de sesión.

Se aplica a

Consulte también