WebMethodAttribute.EnableSession Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Indica se o estado da sessão está ativado para um método de serviço Web XML.
public:
property bool EnableSession { bool get(); void set(bool value); };public bool EnableSession { get; set; }member this.EnableSession : bool with get, setPublic Property EnableSession As BooleanValor de Propriedade
true se o estado da sessão estiver ativado para um método de serviço Web XML. A predefinição é false.
Exemplos
O exemplo abaixo utiliza o estado da sessão para determinar quantas vezes uma sessão específica acede ao método SessionHitCounterdo serviço Web XML .
<%@ WebService Language="C#" Class="Util" %>
using System.Web.Services;
public class Util: WebService {
[ WebMethod(Description="Per session Hit Counter",EnableSession=true)]
public int SessionHitCounter() {
if (Session["HitCounter"] == null) {
Session["HitCounter"] = 1;
}
else {
Session["HitCounter"] = ((int) Session["HitCounter"]) + 1;
}
return ((int) Session["HitCounter"]);
}
}
<%@ WebService Language="VB" Class="Util" %>
Imports System.Web.Services
Public Class Util
Inherits WebService
<WebMethod(Description := "Per session Hit Counter", _
EnableSession := True)> _
Public Function SessionHitCounter() As Integer
If Session("HitCounter") Is Nothing Then
Session("HitCounter") = 1
Else
Session("HitCounter") = CInt(Session("HitCounter")) + 1
End If
Return CInt(Session("HitCounter"))
End Function
End Class
O exemplo de código seguinte é um cliente Web Forms de um serviço Web XML que utiliza o estado da sessão. O cliente persiste o cookie HTTP que identifica unicamente a sessão, armazenando-a no estado da sessão do 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>
Observações
Para armazenar o estado da sessão no objeto ASP.NET HttpSessionState, o serviço Web XML deve herdar de WebService e um WebMethodAttribute aplicado ao método do serviço Web XML, definindo a propriedade EnableSession para true. Se o estado da sessão não for necessário para um método de serviço Web XML, então desativá-lo pode melhorar o desempenho.
Um cliente de serviço Web XML é identificado de forma única por um cookie HTTP devolvido por um serviço Web XML. Para que um serviço Web XML mantenha o estado da sessão para um cliente, o cliente deve persistir o cookie. Os clientes podem receber o cookie HTTP criando uma nova instância de CookieContainer e atribuindo-a à CookieContainer propriedade da classe proxy antes de chamar o método do serviço Web XML. Se precisar de manter o estado da sessão para além do momento em que a instância da classe proxy sai do âmbito, o cliente deve persistir o cookie HTTP entre chamadas ao serviço Web XML. Por exemplo, um cliente Web Forms pode persistir o cookie HTTP guardando-o CookieContainer no seu próprio estado de sessão. Como nem todos os serviços Web XML utilizam o estado da sessão e, por isso, os clientes nem sempre são obrigados a usar a CookieContainer propriedade de um proxy cliente, a documentação do serviço Web XML deve indicar se o estado da sessão é utilizado.