HttpWebClientProtocol.CookieContainer Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает коллекцию файлов Cookie.
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
Значение свойства
Класс CookieContainer представляющий файлы Cookie для клиента веб-службы.
Примеры
В следующем примере кода показан веб-формы клиент веб-службы XML, использующего состояние сеанса. Клиент сохраняет HTTP-файл cookie, который однозначно идентифицирует сеанс, сохраняя его в состоянии сеанса клиента.
<%@ 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>
Комментарии
Если метод веб-службы XML использует состояние сеанса, файл cookie передается обратно в заголовки ответа клиенту веб-службы XML, который однозначно идентифицирует сеанс для этого клиента веб-службы XML. Чтобы веб-служба XML поддерживала состояние сеанса для клиента, клиент должен хранить файл cookie. Клиенты получают HTTP-файл cookie, создав новый экземпляр CookieContainer и назначив его CookieContainer свойству прокси-класса перед вызовом метода веб-службы XML. Если необходимо поддерживать состояние сеанса за пределами экземпляра прокси-класса, клиент должен хранить HTTP-файл cookie между вызовами веб-службы XML. Например, клиент веб-формы может хранить HTTP-файл cookie, сохраняя CookieContainer его в собственном состоянии сеанса. Так как не все веб-службы XML используют состояние сеанса и поэтому клиенты не всегда требуются для использования CookieContainer свойства прокси-сервера клиента, документация по веб-службе XML должна указывать, используется ли состояние сеанса.